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Introduction 



The by Example Series 



How does the by Example series make you a better developer? The by Example 
series teaches software development using the best method possible. After a 
concept is introduced, you'll see one or more examples of that concept in use. 
The text acts as a mentor by figuratively looking over your shoulder and show- 
ing you new ways to use the concepts you just learned. The examples are 
numerous. While the material is still fresh, you see example after example 
demonstrating how to use newly learned material. 

The philosophy of the by Example series is simple: The best way to teach soft- 
ware development is through multiple examples. Language features, feature 
syntax, and language references are not enough to teach a programming lan- 
guage to a newcomer. Only by looking at many examples in which new features 
are immediately used and by running sample programs can a newcomer get 
more than just a feel for the language. 



Who Should Use This Book 



Java 2 by Example was written for developers and nondevelopers who want to 
learn about Java. This book assumes some knowledge of basic computer con- 
cepts (such as binary and hexadecimal), but not much. To get the most out of 
Java 2 by Example, you should have a desire to learn and like to be challenged. 
You don't need to have programmed in another language to use this book, and 
you certainly don't need any familiarity with Java itself. 

You should feel comfortable using a Web browser to navigate the Internet and 
download software because it is recommended that you download Version 1.4 of 
Sun's Java 2 Standard Edition SDK for your platform. Why? This book's exam- 
ples were written and tested using Version 1.4 of that SDK. (Chapter 1 provides 
instructions on downloading and installing the SDK.) 

Sun's Java 2 SDK is available for various platforms (such as Linux, Microsoft 
Windows, and Solaris). Each platform-specific SDK consists of tools designed for 
use in a command window (such as a Microsoft Windows MS-DOS command 
window). If you plan to obtain a copy of the Java 2 SDK (Version 1.4), you 
should be familiar with working in a command window environment. That 
implies that you should feel comfortable using simple commands for navigating 
directories, creating directories, working with environment variables, and run- 
ning programs from the command line. By the way, it is also a good idea to be 
familiar with a platform-specific editor (such as the MS-DOS EDIT program). 



After you've installed the correct version of Sun's Java 2 SDK, you'll learn all 
of the fundamentals of the Java language, everything from basic data types. 
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expressions, and statements to classes, objects, exception handling, and 
threads. In addition to these core Java concepts, you will learn how to use 
several useful Application Programming Interfaces, or APIs. Some of these 
concepts might be difficult for novice programmers, but you'll see dozens of 
examples every step of the way. We've deliberately focused on these intro- 
ductory topics to ensure that by the time you finish reading this book, you'll 
be fully prepared to develop Java applications like a pro. 



This Book's Organization 



Java 2 By Example is organized into fifteen chapters, four appendices, and 
a glossary. The book begins with an introductory chapter, continues with 
ten chapters that discuss the language, and concludes with four chapters 
that discuss a variety of significant APIs. The appendices provide you with 
the answers to all Reviewing It, Checking It, and Applying It questions 
that end each chapter, handy reserved word and operator precedence 
charts, and information on where to obtain additional resources. (Appendix 
B, which covers reserved words, also discusses Java's new assent keyword.) 
Finally, the glossary provides definitions for all italicized terms that appear 
throughout the book. 

There is a subtle point that needs to be made about how this book is orga- 
nized. I have chosen an organizational structure designed to introduce simpler 
concepts first and to build on those concepts in later chapters. The idea is to 
get you comfortable with simple things before moving on to more complex 
things. 



Conventions Used in Tliis Bool^ 



Java 2 By Example uses several conventions that can help you find various 
kinds of information more quickly and understand language syntax. 
Furthermore, this book includes my own idiosyncrasies and adheres to 
Sun's official language conventions — the Java Language Specification. 

^ w I By Example Icons 

c For each of this book's examples, this icon is displayed to the left of that 

^5 example. 



EXAMPLE 



For some of the examples, the example's output is also displayed. This icon 
is displayed to the left of that output. 



OUTPUT 
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Introduction 



Notes, Tips, and Cautions 



NOTE 

Notes augment each chapter by providing additional (and related) concepts. 
TIP 

Tips offer shortcuts and solutions to common problems. 
CAUTION 

Cautions warn about pitfalls from improperly using Java. 

Syntax 

When you are learning a new language, it is important to understand the 
various ways in which language features are combined into meaningful 
source code. That syntax needs to be formally written down by following 
certain conventions. Java 2 By Example observes the following syntax 
conventions: 

• Syntax consists of literal and nonliteral text. Literal text is specified 
by placing that text between quote characters ( ' ) and must be entered 
exactly as it appears (without the quotes). Nonliteral text is specified 
through the use of italics (and not placing that text between quotes). 
Nonliteral text is not entered but serves as a placeholder for literal 
text that must be supplied. 

typeldentifier variableldentifier ' ; ' 

• The vertical bar character ( | ) indicates a choice between a pair of pos- 
sibilities. Furthermore, a choice is surrounded by a pair of round 
brackets (parentheses). 

( 'abstract' | 'final' ) 

• The square bracket characters ( [ ] ) identify an option. Any literal/ 
nonliteral text appearing between those characters is optional. You 
can choose to supply that text or not. 

typeldentifier variableldentifier [ '=' expression ] ';' 

• Three period characters (...) indicate a comma-delimited list of simi- 
lar features or optional extraneous code. 

'throws' exceptionldentifierl ',' exceptionIdentifier2 ',' ... 



Types, Operators, and Statements 

All authors have their own idiosyncrasies, and I am no different. For exam- 
ple, when discussing a primitive type, I talk about the floating-point primi- 
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tive type and not the float primitive type. I do that to draw a distinction 
between the concept of a floating-point primitive type and its representation in 
source code, via the float keyword. However, when it comes to 
reference types, I talk about String, Employee, FilelnputStneam, and so forth: I 
use the name of a class or interface instead of saying string, employee, or file 
input stream reference type. (I don't want to become too pedantic.) When it 
comes to operators, I don't refer to instanceof (for example) as an operator. 
Instead, I mention the relational type checking operator, of which instanceof is 
how you refer to that operator in source code. Finally, I talk about a While loop 
statement instead of a while loop statement because While signifies the concept 
of that statement and while is a keyword that expresses that statement in 
source code. (The same idea applies to other statements.) Although I have made 
every effort to follow those conventions, it is possible that you will run across 
exceptions. If you do, keep in mind that my goal is to distinguish between a 
language concept and its representation in source code (and that I have acciden- 
tally overlooked something). 

Java Language Specification 

Sun's Java Language Specification (JLS) provides the last word on the Java 
language; it is available at the Web site http://java.sun.com/docs/books/ils/ 
second_edition/html/ j .title.doc.html. Every effort has been made to ensure 
that the contents of this book agree with the JLS. 



Where to Get the Book's Source Code 



This book presents a lot of source code — too much source code to enter manually 
without getting frustrated. You can save yourself that frustration by download- 
ing the book's source code from www.quepublishing . com. Just type this book's 
ISBN (0789725932) into the Search field to go to the Web page for this book and 
download the code. 

Also, please visit my Web site (www. j avaj ef f . com) for information about my other 
writings and a survey to help me determine what my next book should include! 



What's Next 



Chapter 1 begins a journey of exploration into the world of Java. That chapter 
defines Java, discusses development tools, looks at different categories of Java 
programs, and compares Java with C++. 



02 71710_Part 1 11/21/01 11:27 AM Page 5 





Exploring the Language 

Introducing Java 
From Unicode to Types 
From Literals to Expressions 
Statements 
Classes and Objects 
Inheritance 
Polymorphism 
Initializers and Nested Classes 
Exceptions and Exception Handlers 
Threads 
Packages 



03 71710_CH01 11/21/01 11:32 AM Page 6 




3 2 AM Page 7 




■4 

1 



Introducing Java 

With Microsoft's release of the C# (pronounced C-sharp) language and the 
.NET platform, you might be wondering whether to spend your time learn- 
ing C#/.NET or to invest that time pursuing Java. To aid you in making an 
informed decision, this chapter starts you on a journey that explores the 
Java language and a few of its many Application Program Interfaces 
(APIs). In this chapter, you will find an answer to the question, "What is 
Java?" You will also learn about Java development tools, the different kinds 
of Java programs that you can create, and how the Java and C++ lan- 
guages compare — which you might find helpful if you come from a C++ 
background. Once you complete this chapter and the rest of this book, I 
hope you will find that learning Java is time well spent. 
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What Is Java? 



What is Java? Java is a combination of a programming language and an 
execution environment. Collectively, the programming language and execu- 
tion environment promote the development of programs that run 
unchanged on many different combinations of hardware and operating sys- 
tem software, and make it extremely difficult (if not impossible) for rogue 
developers to create Java programs that introduce viruses, steal password 
information, crash computing devices, and perform other kinds of malicious 
acts. How does Java accomplish those tasks? This section provides the 
answers. Before exploring those answers, let us examine Sun Microsystems' 
definition of Java. 



NOTE 

Sun Microsystems is the originator of Java, as well as the creative and driving force 
behind Java technology. You can obtain the latest information on Java by visiting Sun's 
Java Web site (http : / / j ava . sun . com). 



A Basic Definition 

Sun defines Java as a "simple, object-oriented, network-savvy, interpreted, 
robust, secure, architecture-neutral, portable, high-performance, multi- 
threaded, dynamic language." That's quite a mouthful! Let's go through 
that definition point by point. 

Java is a simple language. That simplicity yields a gentle learning curve 
for newcomers, allowing them to become productive in a rapid manner. 
Java's designers realized that many developers have experience in C and/or 
C++. That knowledge led them to simplify Java by basing its syntax on 
CIC++. However, some of the more onerous features found in C++ (such as 
operator overloading, multiple implementation inheritance, and the destruc- 
tor) and in both C and C++ (such as the pointer and automatic type 
coercion) were banned from Java. Banning those features (which were often 
poorly understood by new developers) has helped keep Java simple. 

Java is an object-oriented language. A Java developer is focused on solv- 
ing a problem by using the language to model the problem in source code. 
You accomplish that by representing each problem entity with an object 
that combines the entity's state and behavior and by specifying the interac- 
tions between those objects. In contrast, a non-object-oriented language 
developer focuses on changing the problem into something equivalent that 
fits the language. As a result, even though non-object-oriented and object- 
oriented programs solve the same problem, a non-object-oriented program's 
source code is typically much harder to understand and maintain than its 
object-oriented counterpart. 
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Java is a network-savvy language. Java's extensive TCP/IP network 
library makes it easy to establish connections to various TCP/IP processes 
(such as HTTP and FTP) that are running on networked machines. 
Furthermore, that library uses the same mechanism to access objects over 
a network and on the local file system, so when you understand how Java 
handles file access, you automatically understand how it handles network 
access, which saves time. In a world of e-commerce, being network-sawy is 
very important. 

Java is an interpreted language. A Java compiler translates Java source 
code into instructions called bytecodes. Those bytecodes execute (also known 
as run) on a virtual machine — a computer program that mimics a computer. 
The virtual machine executes bytecodes by interpretation (a mechanism 
that reads a bytecode, figures out its meaning, and executes equivalent 
microprocessor instructions on the platform — the underlying computer 
architecture and operating system — where the virtual machine is 
executing). 



NOTE 

Developers often refer to Java's virtual machine as the JVM or Java VM. 



Java is a robust language. In other words, the language helps the devel- 
oper write code that is less likely to fail, which is beneficial for those devel- 
opers whose careers might be on the line if they deliver faulty products. In 
part, Java achieves robustness by forcing stricter type checking than found 
in languages like C and C++, by eliminating pointers (which can lead to 
program crashes and security violations), by providing true arrays with 
bounds checking to prevent access to nonexistent array elements, and by 
taking on the responsibility of freeing dynamically allocated memory by 
using a behind-the-scenes garbage collection mechanism. 



NOTE 

In a language where developers dynamically allocate and free memory (such as C++), 
they sometimes forget to free that memory, resulting in memory leaks that cause run- 
ning programs to gradually "grind to a halt." Because Java's garbage collection mecha- 
nism takes on the responsibility of freeing dynamically allocated memory, memory leaks 
are far fewer. (Leaks can still happen in Java, but this book will teach you how to avoid 
them.) 



Java is a secure language. The compiler, in partnership with the JVM's 
interpreter, provides a variety of checks to ensure that viruses and other 
"nasty" programs cannot infect a computer's files. That is of great impor- 
tance in a networked environment, where it's possible to download and 
execute Java software without knowing who authored the code and what it 
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does. Without security, you wouldn't know (until after the fact) if executing 
a Java program causes your credit card or password information to be 
stolen, files on your hard drive to be deleted, or reams of paper on your 
printer to be wasted. Java's security capability is very flexible: Security 
ranges from completely secure (for applets) to completely unsecure (for 
applications). 



NOTE 

It is possible to make applications more secure by installing a security manager — a 
special kind of object that works in partnership with the JVM to promote security. 
Unfortunately, a discussion of security managers and other security topics is beyond 
the scope of this book. 



Java is an architecture-neutral language. Basically, you write a program 
once, compile that program once, and it should (in theory) run on any Java- 
supported architecture — from the smallest consumer device (such as a cel- 
lular phone or a pager) to personal computers and the largest mainframe. 
Although that arrangement works remarkably well for the most part, there 
are a few "gotchas" that a developer must keep in mind: Some of those 
"gotchas" will be examined throughout this book. Architecture neutrality 
(also known as platform independence) is made possible by a compiler that 
generates executable code that targets a JVM and not a specific computer 
architecture. 

Java is a portable language. It forces primitive types (such as integer and 
floating-point types) to be the same size on any platform. That is in sharp 
contrast to languages like C and C++, whose integer types can vary in size 
from one platform to another. Also, Java uses abstract classes and inter- 
faces to "protect" programs from the architectural differences of various 
platforms. For example, to work with graphics, a Java program calls upon 
the capabilities of an abstract class. In turn, that abstract class communi- 
cates with a platform-specific class that carries out the actual graphics 
operations. Finally, most of Java (such as the compiler) is written in Java, 
whereas that part of Java that communicates with the platform is written 
in C or C++ — resulting in a clean boundary. That clean separation makes it 
easier to port Java to different platforms, because only those parts of Java 
written in C or C++ need to be ported. 

Java is a high-performance language. Although older versions of Java 
were much slower (because of the nature of interpreting bytecode instruc- 
tions), Java's execution speed has improved through the introduction of 
Just-In-Time (JIT) compilers. Modern JVMs include JIT compilers that 
compile bytecodes into a platform's native microprocessor instructions while 
a Java program is running, resulting in a runtime performance boost. 
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Java is a multithreaded language. Multithreading divides a program's 
overall execution into multiple discrete paths of execution (known as 
threads) that run either at the same time (if the underlying platform uses 
multiple microprocessors — one microprocessor per thread) or nearly at the 
same time (if the underlying platform uses a single microprocessor — shared 
between all threads). For example, a multithreaded program can respond to 
user input while sorting a large amount of information. Although languages 
like C and C++ also support multithreading (at the API level), much more 
work is required because, unlike Java, neither C nor C++ provides lan- 
guage support for synchronizing access to shared data. Without synchro- 
nization, it is possible for one thread to read a data item that is being 
written to by another thread, and getting only part of the new value. The 
result is corruption. However, when used carefully, multithreading offers a 
performance enhancement to Java programs. 

Java is a dynamic language. Java adapts to a continually evolving envi- 
ronment by deferring the connection between programs and libraries until 
runtime and by using interfaces that specify what objects do and not how 
they do it. (The "do it" part is left up to the classes that implement inter- 
faces and from which objects are created.) As long as the interfaces to a 
class are kept the same and a program communicates with those interfaces, 
the behaviors of an object's class can change without breaking code. 
Furthermore, unlike C++, Java has the capability to take an arbitrary 
object address and return the object's actual type. That capability helps 
make Java even more dynamic. 

A Program Development and Execution Environment 

A Java program begins with source code. You start up an editor, enter a 
Java program's source code, and save that code to a file. When choosing a 
filename, it's important to specify . j ava as the file extension. If you don't 
specify that extension, some Java compilers (with Sun's j avac compiler 
being most notable) won't recognize the source file. 

A Java compiler is responsible for converting the contents of the Java 
source file into bytecodes (that is, JVM instructions) and related data. 
Because that source code is based on classes, the generated bytecodes for 
each encountered class are placed into their own class file. Figure 1.1 illus- 
trates the compilation process. 

Assuming successful compilation, a program has been created. To execute 
that program, one of the class files — known as the starting class file — must 
load into the JVM by way of the JVM's class loader logic. 
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Java source file 
(Fred.java) 



compile 
■f 

Java class file 
(Fred.class) 



Figure 1.1: The Java compiler converts the source code of a class called 
Fred (in Fred . Java) to equivalent bytecodes and related data. The compiler 
stores those bytecodes (and data) in a class file called Fred, class. 

After the class loader completes loading the starting class file, it requests 
the JVM's bytecode verifier logic to ensure that the class file's bytecodes are 
valid and don't violate Java's security restrictions. If the bytecode verifier 
discovers a security violation, it forcefully terminates the JVM. 

Assuming successful verification, the JVM's interpreter interprets the start- 
ing class file one bytecode instruction at a time, and the program runs. The 
interpreter typically performs its task in partnership with a JIT compiler. 
When the interpreter discovers that a bytecode sequence is being repeat- 
edly executed, it causes the JIT compiler to compile that bytecode sequence 
into a platform's native instructions. Those native instructions then execute 
whenever the bytecode sequence is encountered in further execution. The 
result is a significant performance boost. 

While interpreting bytecodes, the interpreter might encounter a request to 
execute bytecodes in another class file — possibly a class file from Java's 
extensive class library. If that happens, the interpreter contacts the class 
loader to locate and load that class file. After the new class file loads, the 
JVM's bytecode verifier logic verifies the class file's bytecodes. If the byte- 
code verifier discovers a security violation in those bytecodes, it terminates 
both the JVM and the running program. Assuming success, the interpreter 
starts interpreting those bytecodes. That process of request/load/verify/ 
interpret continues until the program completes, either normally or because 
of a failure (ranging from a simple divide-by-zero attempt to a complex 
input/output attempt that goes wrong). Figure 1.2 illustrates the class load- 
ing, bytecode verification, and interpretation process. 
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1 ) Class loader reads class file and stores its bytecodes (and 
related data) in memory. 

2) Bytecode verifier validates those bytecodes to ensure they do 
not violate Java's security restrictions. If a violation is discovered, 
the currently running Java program and JVIVI are forcefully 
terminated. 




Figure 1.2: A Java program executes as follows: The JVM's class loader 
loads each class file ( that constitutes the program) into memory, the JVM's 
bytecode verifier validates the instructions that are in that memory, and the 
JVM's interpreter (in partnership with a JIT compiler) executes those 
instructions. 



A Brief History 

Now that you have a better idea of what Java is and the mechanics of its 
program development and execution environment, you might be curious 
about Java's origins. How did Java originate? 

Java's origins date back to December 1990. At that time, Patrick Naughton, 
Mike Sheridan, and James Gosling — all Sun employees — were given the task 
of figuring out the next significant trend in computing. Those men came to the 
conclusion that the convergence of digitally controlled consumer devices and 
computers would be very significant. Thus, Sun's Green project was bom. 

In addition to an impressive piece of hardware running a small-footprint 
version of Unix, the Green project resulted in the development of a lan- 
guage based on C and C++. Its creator, James Gosling, decided to call that 
language Oak — after an Oak tree growing outside his office window at Sun. 
Oak was later changed to Java when it was discovered that another lan- 
guage with the same name already existed. 
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NOTE 

You can learn more about the early days of Green and Oak/Java — along with the origins 
of Sun's cartoon Java mascot Duke — by visiting http: //java. sun.com/people/iag/ 
green/index . html. 



Green experienced difficulties. Back in the early 1990s, the market for 
intelligent consumer devices was developing very slowly — too slowly for 
Sun's needs. Furthermore, Sun lost a major contract involving Java to 
another company. As a result. Green came close to being canceled. However, 
in 1994, Java's future began to brighten as the infant World Wide Web 
started to become very popular. Sun noticed an opportunity for Java to be 
used to deliver dynamic content to Web pages and commissioned the Green 
team to develop a Java-based Web browser (which would become known as 
HotJava) that could embed (and run) small Java programs (which would 
later be called applets) in Web pages. Netscape Communications, noticing 
an opportunity to increase browser market share, contracted with Sun to 
get Java into Netscape's Web browser. (Microsoft later followed Netscape's 
lead by contracting with Sun to have Java included with the Internet 
Explorer Web browser.) 

In May 1995, Sun gave a formal presentation on Java to a major confer- 
ence. The business community found Java to be interesting because of the 
popularity of the World Wide Web. (It didn't hurt that Java was designed 
for commercial reasons.) Interest in Java continues to grow because Java is 
well suited to today's e-commerce projects, especially on the server side of a 
client/server e-commerce solution. 



Development Tools 



To develop Java programs, you need appropriate development tools. 
Whether you are looking for simple tools that are freely available or more 
substantial products (which usually cost something), a wide variety of 
development tools exist for creating Java programs on the Solaris, Mac OS, 
Linux, Windows, and other platforms. 

From JDK to SDK 

In the fall of 1995, Sun released the very first Java Development Kit (JDK). 
JDK 1.0 was released for the Windows 95/NT and Solaris platforms and 
consisted of a compiler, related tools, examples, and documentation. 
However, JDK 1.0 was not very useful beyond the creation of simple pro- 
grams. As a result. Sun "beefed up" Java to support component develop- 
ment, by integrating a new event-handling model (among other things), and 
JDK 1.1 debuted. 
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One major problem with JDK 1.1 was its Graphical User Interface (GUI) 
subsystem. That subsystem, known as the Abstract Windowing Toolkit 
(AWT), was limited in what it could do because of its ties to the underlying 
platform. Furthermore, GUIs created with the AWT didn't look the same 
when viewed under Solaris, Windows, and Mac OS. Those limitations led 
Sun to develop Swing, an extended and enhanced AWT. Swing makes it 
possible to develop sophisticated GUIs that can either look platform-specific 
or look identical on any Java-supported platform. Swing's inclusion into the 
JDK marked a significant milestone — Java 2. 

Instead of calling its next major Java release JDK 1.2, Sun made a signifi- 
cant name change. The next release became known as the Java 2 SDK 
(Software Development Kit) version 1.2. There was a good reason for that 
change of name. Developers wanted to use Java on both the client and 
server sides of large projects. Furthermore, they also wanted to use Java on 
small consumer devices. Imagine incorporating all of the capabilities for 
those three areas of use into one product. The result would be an enormous 
development kit, and not all of those capabilities would be needed by all 
Java developers. To simplify the SDK, Sun released three separate editions 
of Java 2: 

• Java 2 Platform, Standard Edition 

• Java 2 Platform, Enterprise Edition 

• Java 2 Platform, Micro Edition 

You primarily use the Java 2 Platform, Standard Edition SDK to create 
client-side programs, although support for server-side interaction is part of 
that development kit. In contrast, the Java 2 Platform, Enterprise Edition 
SDK emphasizes server-side development. Finally, the Java 2 Platform, 
Micro Edition SDK is geared towards those developers who create pro- 
grams for consumer devices (such as cellular phones, smart cards, pagers, 
and car navigation systems). 

Following Sun's introduction of the three development kits, each development 
kit independently progressed through various versions. For example, subse- 
quent to the release of Java 2 Platform, Standard Edition version 1.2, Sun 
released version 1.3 and (now) version 1.4 of that edition. Visit Sun's Products 
& APIs Web page (http://www.iavasoft.com/products/7frontpage-main) to down- 
load and learn more about the latest versions of each development kit. 
Furthermore, because this book focuses on Java 2 Platform, Standard Edition 
version 1.4, you can visit Sun's Summary of New Features and Enhancements 
Web page (http: //iava.sun.com/ j2se/1 .4/docs/ relnotes/f eatures . html) to 
learn more about what's new in version 1.4. 
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NOTE 

The introduction of JDK 1.1 resulted in Apple porting Java to its Mac OS-based plat- 
form. Apple's Java implementation became known as Macintosh Runtime for Java 
(MRJ), with MRJ 2.2.5 being Apple's most current release of that product (at the time 
this chapter was written). 

Apple based MRJ 2.2.5 on Sun's JDK 1.1.8. That decision resulted in Java features 
(including SDK 1.4 features) beyond JDK 1.1.8 not being available to Mac developers. 
However, Apple's 2001 release of Mac OS X brings new versions of Java to the Mac. 

Mac OS X includes version 1.3 of the Java 2 Platform, Standard Edition. Although 1.4 is 
not supported (at the time this chapter was written), that situation will most likely 
change (and rather quickly). 

To obtain a copy of MRJ 2.2.5, point your Web browser to http://www.apple.com/ 
java. However, if you want to learn about the latest release of Java on Mac OS X, 
check out Apple's "Java Development for Mac OS X" PDF document at http: // 
developer, apple.com/macosx/pdf /macosx_java. pdf. 



Downloading SDK 1.4 

Assuming you would like to work directly with Sun's SDK 1.4 (and not a 
development tool that integrates SDK 1.4), you can begin the process of 
downloading SDK 1.4 by pointing your browser to the following Web page: 
http://www.iavasoft.com/i2se/. That Web page contains the Current 
Releases, Related Technologies, and Previous Releases categories of links to 
the Java 2 Platform, Standard Edition product family. 

Under Current Releases, you'll discover links to the SDK, Java Runtime 
Environment (JRE), and documentation. Click the SDK link to continue the 
SDK download process. 



NOTE 

JRE stands for Java Runtime Environment. Basically, the JRE is the SDK without devel- 
opment tools and examples. It is smaller than the SDK and is typically downloaded and 
installed on computers where Java programs are to be run, but not developed. (Java 
programs can run on the machine where they are developed because the SDK contains 
a copy of the JRE.) 

The SDK's documentation is bundled separately from the SDK, for size reasons. If the 
documentation was included with the SDK, you'd probably end up downloading more 
than 50 megabytes at one time. Also, the documentation is periodically updated. As a 
result, it wouldn't make sense for developers to have to redownload the SDK just to 
obtain the updated documentation. After the SDK is downloaded, you will need to click 
the documentation link if you choose to download the documentation. However, if you 
would rather not download the SDK documentation, you have the option of viewing that 
documentation online by "surfing" to the Web page at the following address: http: // 
java. sun. com/j2se/1 .4/docs/. 
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After you click the SDK link, you'll be taken to the Java 2 Platform 
Standard Edition Version 1.4 Web page. The center of that page's top area 
reveals links for downloading Solaris SPARC/x86, Linux x86, and Microsoft 
Windows versions of SDK 1.4. Click the link that is appropriate for you. 
Let's assume you want to download SDK 1.4 for Windows. 

On the SDK for Windows Web page, you can choose to download SDK 1.4 
as one large bundle, or as "multiple disk size pieces (each -1.44 MB or 
less)." Information on combining the multiple pieces into the equivalent 
large bundle is provided on the download Web page. 



TIP 

If you are using a modem to connect to the Internet, you might want to choose the 
smaller multiple disk size pieces option. The reason is that some Internet service 
providers (ISPs) tend to drop the line connection after you've been connected for a cer- 
tain length of time. If your ISP drops the connection, you must restart the SDK down- 
load from the beginning. That is not good when downloading the SDK as one large 
bundle, which could take a long time to download on a 56K modem. In contrast, you 
only lose a single 1.44MB piece (which only takes a few minutes to download) when 
downloading the SDK in multiple pieces. 



Assuming you decide to go with the large bundle option and have clicked 
the Continue button, you are taken to the license agreement Web page. 
Click the Accept button to accept the terms of that agreement and continue 
with the download process. 

The next Web page to appear contains several buttons from which you can 
download the SDK. Click a button containing an FTP download label unless 
you are behind a firewall. In that case, you will need to click the HTTP 
download button. In either case, a Save As dialog box will be displayed (by 
the browser) that prompts you to choose a location in which to save the 
SDK installation file (i2sdkl_4_0-win.exe). 

After the SDK installation file has completed its download, run that pro- 
gram and follow the onscreen prompts to install SDK 1.4. You will also need 
to update your system's path to include the location of the SDK tools. On 
Windows, you would update the path environment variable to include the 
idkl .4\bin directory. (Even though the term SDK is widely used, the instal- 
lation program still creates — for historical reasons — a default jdk directory 
as the Java installation's parent directory.) Assuming the SDK has been 
installed to c: \jdkl .4, you can update PATH either by appending c: \ idkl .4 
to the current PATH setting (as in PATH=%PATH%;c: \idkl .4\bin) in your 
autoexec.bat file (for Windows 95/98/ME users) or by using the Control 
Panel's Environment tool (for Windows NT/2000/XP). 
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Touring the Windows Version of SDK 1.4 

After you've installed SDK 1.4, you might be curious as to what is now pre- 
sent on your computer. Underneath the jdkl .4 directory, you'll find several 
files: README.txt, readme.html, COPYRIGHT, LICENSE, Uninst.isu, and snc.jar. 

The README.txt and readme.html files contain useful introductory informa- 
tion (such as system requirements and links to various Web sites contain- 
ing additional information) in text and HTML format. You should read 
either file after installation, to start learning about the SDK. 

The COPYRIGHT and license files contain Sun's mandatory copyright and 
licensing agreement information. Even if you typically ignore those files, it 
might not be a bad idea to quickly review their contents. 

You might notice a strangely named file called Uninst . isu. That file con- 
tains information used in the removal of the SDK. Do not delete or modify 
that file. Without Uninst. isu, you won't be able to uninstall the SDK. 



TIP 

It's a good idea to uninstall a previous version of either the JDK or SDK before 
installing any JDK/SDK version (including SDK 1.4). Otherwise, conflicts between differ- 
ent installed versions might arise, leading to many hours of frustration in tracking down 
the source of those conflicts. Also, if an environment variable called CLASSPATH exists 
under your operating system, you might want to delete that environment variable after 
removing the previously installed JDK/SDK. 



The final file you'll encounter in the jdkl .4 directory is src. jar. That file is 
a ZIP archive that contains the source files to Java's extensive library of 
pre-created classes. Later in this book, you'll learn how to extract source 
files from that archive, so you can study the source code to various classes 
(such as file and networking classes). 

The jdkl .4 directory also includes several directories: bin, jne, lib, include, 
demos, and docs. 

The bin directory contains useful tools, including the j avac . exe compiler 
and various program launchers. 

The j re directory contains the SDK's copy of the JRE. When you install 
SDK 1.4 (and other SDK/JDK versions), the SDK installer installs either 
one or two copies of the JRE. The JRE contained in the j re directory is 
always installed. However, you have the option of installing a separate JRE 
(bundled with the SDK). That other JRE corresponds to the JRE that can 
be downloaded (without the SDK) from Sun's Web site. Because I chose to 
install that other JRE on my platform (when I installed SDK 1.4), my copy 
of that other JRE is located at c: \Program Files\iavasoft\ire. 
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Why are there two copies of the JRE? The j dkl . 4\ j re JRE is not as stream- 
hned as the c: \Program Files\]avasoft\ j re JRE. Having that latter JRE is 
useful for testing programs in an environment similar to an environment in 
which only a JRE is installed. Having the first JRE is necessary if you 
chose not to install the latter JRE when installing the SDK. After all, with- 
out a JRE, the SDK tools won't be able to compile Java source code and run 
Java programs. If the latter JRE is not installed, the SDK uses the first 
JRE. Otherwise, it uses the latter JRE. 

TIP 

To download the SDK 1.4 JRE, visit the Web page at http: / / java.sun.com/j2se/ 
1 .4/ j re. 

The lib directory contains a variety of library files that support the various 
SDK tools, whereas the include directory contains C-style header files that 
are used in partnership with the Java Native Interface (JNI) to connect 
Java code to non-Java code. Unless you need to create foreign code that 
communicates with Java, you won't need to use the JNI. 

The SDK includes a complete set of demonstration programs (plus their 
source code). If you chose to install those programs during installation, a 
demos directory will have been created. You can play with the programs in 
the various directories underneath demos and study each program's included 
source code to learn more about how to write Java software. 

Earlier, you learned that you need to download the documentation sepa- 
rately. After the documentation is downloaded, unarchive the documenta- 
tion hierarchy from the documentation archive. The root of that hierarchy 
is a directory called docs. Sun recommends moving docs into the jdkl .4 
directory. Consult the documentation installation instructions Web page at 
http : / / www. j avasof t . com/ j 2se/1 . 4/ install - docs . html for more information 
on how to perform that task. 

Later in this chapter, a tutorial will be presented that compiles and runs a 
program using SDK 1.4's compiler and one of its program launcher tools. 
Because that tutorial is Windows-based, you will have to extrapolate what's 
shown to your own platform if you are not working with Java on a Windows 
platform. 

Commercial Development Tools 

The problem with Sun's Java 2 SDK is that the SDK's development tools 
force you to work in a command window (such as the Windows MS-DOS 
command window). There is no GUI-based Integrated Development 
Environment (IDE) that simplifies building and testing Java programs. 
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If you prefer to work with an IDE, you'll need to investigate various tools 
built around an IDE framework. Commercial tools, though often costly, 
offer sophisticated IDEs that can speed up the development process. 

To begin, you might want to examine Sun's Forte product. Forte sports an 
IDE for facilitating Java development and comes in two separate editions: 
Community and Internet. Forte Community Edition includes a set of tools 
for developing different kinds of Java programs and is available at no 
charge. However, Forte Internet Edition adds support for developer teams 
and must be purchased. To learn more about Forte, visit Sun's Forte for 
Java Web page (http: / /www. sun. com/f orte/ff j /). 

Another tool worth checking out is IBM's Visual Age for Java. That product 
can be used to develop Java programs that run on anything from Windows 
NT to OS/390 mainframes. To learn more about Visual Age for Java, visit 
IBM's Visual Age Web page (http: //www-4. ibm.com/software/ad/vajava/). 

Finally, you might be interested in Borland's JBuilder product. That prod- 
uct has received much praise (including PC Magazine's Editors' Choice). 
Information on JBuilder is available at http://www.borland.com/ibuilcler/. 

TIP 

Following development and testing, Java developers are faced with the important task 
of deployment. Deploying a Java program requires a copy of the JRE to be installed on 
the target computer before the Java program can be run. Also, the correct version of 
the JRE must be installed. That task becomes even more complicated if you need to 
create deployment code that installs the program on multiple platforms. Fortunately, 
that situation can be simplified by making use of InstallAnywhere. 

Zero G Software's InstallAnywhere product creates a universal installer for client or 
server programs. According to Zero G, that installer can install the program on any Java- 
supported platform in the world. To learn more about InstallAnywhere, visit the Zero G 
Web site (http://www.zerog.com). 



Freeware Development Tools 

For cost-conscious developers, a variety of freeware development tools are 
at your disposal. Although you don't have to shell out cash, a freeware tool 
probably won't offer as many features (or even product support) as its com- 
mercial "cousins." Regardless, two useful products in the freeware category 
worth investigating are NetBeans and JCreator. 

NetBeans is the result of an open-source project focused on developing a 
modular and standards-based IDE. Because NetBeans is open-source, 
that product's source code is freely available. For more information on 
NetBeans, check out the NetBeans Web site (http: //www. netbeans.org/). 
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Finally, JCreator offers a very small IDE that uses the SDK in the back- 
ground as a compiler. Among its features, JCreator's IDE offers auto-word 
completion, auto-indent, and instance color syntax highlighting. JCreator's 
Web site (http: //www. jcreaton.com) provides more information on that 
useful product. 



Java Programs 



After you finish downloading and installing version 1.4 of Sun's Java 2 
Platform, Standard Edition SDK (or obtain some kind of development tool 
that supports that version), you will want to write, compile, and run your 
first Java program. However, before starting that project, you need to real- 
ize that there are four categories of Java programs: applets, servlets, 
JavaBeans components, and applications (which can be divided into GUI 
applications, command-line applications, and embedded applications that 
are built — by the Java 2 Platform, Micro Edition — for use in cellular 
phones, embedded computers, and so on). Each category's programs are 
written and run differently. Therefore, it is a good idea to familiarize your- 
self with those program categories before creating your first masterpiece. 

From Applets to Applications 

When newcomers to Java think of Java technology, applets probably come 
to mind before anything else. After all, applets are prevalent on the World 
Wide Web, and a newcomer has probably interacted with one or more 
applets during a "Web surfing" exercise. Basically, an applet is nothing 
more than a Java program running in the context of a client computer's 
Web browser program. The Web browser controls the applet and limits 
what that program can do (for security reasons). 

The computer on which your Web browser is running is known as a client. 
To make "surfing the Web" a reality, the Web browser communicates with a 
Web server program running on a server computer. That other computer is 
known as a server because it "serves" Web pages to your Web browser. Just 
as a Java-enabled Web browser can run applets, a Java-enabled Web server 
can run servlets. A servlet is the server-side equivalent of an applet and can 
cooperate with applets to accomplish significant tasks. For example, an 
applet displays a GUI to its user. That GUI allows the user to interact with 
the applet. During that interaction, the user might request the applet to 
obtain some information stored in a database. The applet sends that 
request to its servlet counterpart, and the servlet retrieves the information, 
which it passes to the applet. The applet ends up displaying that infor- 
mation to the user. 
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Like other object-oriented languages, Java supports software development 
via the concept of components. That support manifests itself via a 
JavaBeans component — a Java program building block that runs in the 
context of other programs. 

Unlike programs belonging to the other three program categories, an appli- 
cation is a standalone program (like a Windows EXE file). Applications are 
very versatile and can be used to run applets, servlets, or JavaBeans 
components. 

NOTE 

Apart from this chapter's Craps GUI application, this book focuses exclusively on 
command-line applications. 




EXAMPLE 



Your First Application 

The best way to start learning about applications is to examine the source 
code to an introductory application. In many books, that source code is typi- 
cally very short and specifies some variation on the traditional "hello world" 
application. In contrast, the book you are reading is very different. Forget 
about "hello world"! In this book, your first application plays a casino game 
called Craps and sports its own GUI. Also, the source code is much more 
interesting. Before examining that source code, how does one play Craps? 

Craps is a game played with two dice. Each die has six faces, and each face 
consists of one, two, three, four, five, or six spots. A player rolls those dice 
and throws them. After the dice have come to rest, the sum of the spots on 
their upward faces is calculated. After the first throw, if the sum is 7 or 11, 
the player has rolled a "natural" and wins. If that sum is 2, 3, or 12, the 
player has rolled "craps" and loses. Finally, if the sum is 4, 5, 6, 8, 9, or 10, 
that sum becomes known as the player's "box point." The player must con- 
tinue rolling the dice until either the box point is made (that is, the sum of 
the dice is the same as the previous sum) and the player wins, or the player 
rolls a 7 and loses. 



Source Code 

Now that you know something about the game of Craps, it's time to look at 
the source code. Although the source code has been extensively docu- 
mented, don't feel as if you need to understand it all right now. There is a 
lot of code, and it gets rather involved. For now, consider studying the code 
just to get some idea of what Java source code looks like. As you progress 
through subsequent chapters, you will learn about the many non-GUI 
things that go into creating an application like Craps. When you are fin- 
ished reading this book, come back and study the source code in detail. By 
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that time, it will probably make a lot more sense. Listing 1.1 presents the 
source code to Craps. 

Listing 1.1: Craps. Java. 
// Craps. java 

// This program constructs a Graphical User Interface (GUI) as well as 
// all necessary logic for playing the game of Craps. 

// The following import directives tell the Java compiler the location 
// of classes (such as Frame and ActionListener) used to construct the 
// GUI. 

import java.awt.*; 
import java.awt. event.*; 

// Class: Craps 

// 

// This class is the main class for the Craps program. It inherits 
// capabilities from the Frame class so that Craps can have its own 
// top-level frame window. Furthermore, it implements an interface 
// called ActionListener -- by providing code to this interface's 

// actionPerformedO method. 

// 

class Craps extends Frame implements ActionListener 
{ 

int oldSum; // This variable keeps track of the first roll's sum. 
Die d1 , d2; // These variables reference a pair of Die component 
// objects. 

Label 1; // This variable references a Label component object. 

// The following firstRoll variable distinguishes between the first 
// and second dice rolls. This variable's value is true if the 
// current roll is the first roll. 

boolean firstRoll = true; 

// ================================================================ 

II Method: Craps() 

// 

// Construct the Craps program's GUI. 

// 

// This method is known as a constructor method because its purpose 
// is to construct an object from the Craps class. Constructor 
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Listing 1.1: continued 

// methods always have the same names as the classes in which they 
// are declared. Furthermore, constructors do not have return 
// types -- not even void return types. 

// 

// Arguments: 

// 

// title - a message appearing in the frame window's title bar 

// 

Craps (String title) 
{ 

// Craps inherits capabilities from the Frame class. As such, 
// Craps is a specialized frame window with a title bar, border, 
// and decorations. The following super (title); code calls the 
// superclass's (that is. Frame's) constructor. In turn, 
// Frame's constructor ensures that the contents of the title 
// appear in the frame window's title bar. 

super (title); 

// Each frame window has a system menu for moving, minimizing, 

// maximizing, restoring, and closing the frame window. Under 

// Windows and other platforms, you also see three small buttons 

// on the righthand side of the frame window's title bar. Under 

// Windows, the rightmost button is labelled with an X. This 

// button is clicked to close the frame window and terminate the 

// program. 

// Because we want to terminate the program when either close is 

// selected from the system menu or the X is clicked, we add a 

// window listener to the frame window, by calling Frame's 

// addWindowListener( ) method. When the user chooses to close 

// the frame window (using either of the aforementioned 

// techniques), a window closing event is generated. 

// The argument to the addWindowListener( ) method is the address 

// of an event handler that includes the windowClosing( ) method. 

// We can add this handler in one of two ways: the first way is 

// to implement an interface called WindowListener. If we do 

// this, we must provide code for several methods in addition 

// to windowClosing( ) . The second way is to create an object 

// from an anonymous subclass of WindowAdapter and override the 

// windowClosing( ) method. This second approach is what has 

// been done. 
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Listing 1.1: continued 

// To terminate the program, System. exit (0); is called in the 
// windowClosing( ) method. 

addWindowListener (new WindowAdapter () 
{ 



Method: windowClosingO 

Handle the window closing event -- 
initiated when either the X button is 
clicked or the close menu item is 
selected from the system menu. 

Arguments: 

e - the address of an event object 
that describes the window close 

Return: 

nothing 



public void windowClosing (WindowEvent e) 
{ 

// Terminate the program. 
System. exit (0); 

} 

}); 

// Create a Panel container object for organizing the dice. 
Panel p = new Panel ( ) ; 

// Create the dice and add their Die component objects to the 
// panel. 

p. add (d1 = new Die ( ) ) ; 
p. add (d2 = new Die ( ) ) ; 

// Add the panel to the northern area of the frame window, 
add (p, BorderLayout. NORTH) ; 
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Listing 1.1: continued 

// Create a Label component object for displaying win/lose 
// messages. 

1 = new Label ( ) ; 

// Set the label's alignment {by passing Label's CENTER 

// constant to the appropriate Label constructor) so that label 

// text appears centered. 

l.setAlignment (Label. CENTER) ; 

// Add the label to the center area of the frame window, 
add (1); 

// Create a Button component object labeled Roll. 

Button b = new Button ("Roll"); 

// Register an object, whose class implements the 

// actionPerformed( ) method, declared in the ActionListener 

// interface, with the button. The word "this" identifies the 

// current Craps object as the object being registered. When 

// the Roll button is clicked, the actionPerformed( ) method in 

// the Craps class is called. Code placed in that method 

// handles this "action" event. 

b.addActionListener (this); 

// Create a new Panel container object to contain the button. 
// This is done so the button appears at a more natural 
// (smaller) size. 

p = new Panel ( ) ; 

// Add the button to the panel. 

p. add (b); 

// Add the panel to the southern area of the frame window, 
add (p, BorderLayout. SOUTH) ; 

// Set the size of the frame window to 200 pixels horizontally 
// (the leftmost argument) and 200 pixels vertically. 
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Listing 1.1: continued 

setSize (200, 200); 

// Make the frame window visible. 

setVisible (true); 



Method: actionPerformedO 

Handle the action event initiated with the click of the Roll 
button. 

Arguments: 

e - the address of an event object that describes the button 
press 

Return : 

nothing 



public void actionPerf ormed (ActionEvent e) 
{ 

// Roll each die by generating a random number between 1 and 6. 

// Math . random( ) returns a random number between 0.0 and 1.0 -- 

// but not 1.0. This value is multiplied by 6 and converted to 

// an integer value between 0 and 5 (inclusive), by the (int) 

// cast. One is added to the result so that the value is a die 

// value between 1 and 6 (inclusive). 

int valuel = (int) (Math. random () * 6) +1; 
int value2 = (int) (Math. random () * 6) +1; 

// Draw the dice with the new values. These values represent 
// the number of spots on their visible surfaces. 

d1 .draw (valuel ) ; 
d2.draw (value2) ; 

// Calculate the sum of spots on the die's visible surfaces. 



int sum = valuel + value2; 
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Listing 1.1: continued 

// If this is only the first roll ... 

if (firstRoll) 
{ 

// Clear any message text currently displayed, via the Label 
// component object (referenced by 1). 

l.setText (""); 

// If the sum is 7 or 11, the player wins, so display this 
// message in the label. However, if the sum is 2, 3 or 12, 
// the player loses. The resulting message is displayed in 
// the label. 

if (sum 7 1 1 sum 11 ) 
l.setText ( "You win. " ) ; 

else 

if (sum 2 1 1 sum == 3 | | sum 
l.setText ( "You lose. " ) ; 

else 
{ 

// Because neither 7, 11 , 2, 
// save the sum for the next 

oldSum = sum; 

// Clear the firstRoll flag variable so that the program 
// "knows" the next roll is the second roll, and not a 
// new first roll. 

firstRoll = false; 

} 

// Leave the actionPerformed() method, 
return; 

} 

// The following code is only reached on the second roll. If 
// the new sum matches the old sum, the player made the needed 
/ / point and wins. 



12) 



3, nor 12 were generated, 
roll. 



if (sum oldSum) 
{ 

// Display winning message in the label. 
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Listing 1.1: continued 

l.setText ("You made your point. You win."); 

// Set the firstRoll flag variable to true so that the 

// program "knows" the next roll is the first roll of a new 

// game. 

firstRoll = true; 

// Leave the actionPerformed( ) method, 
return; 

} 

// If the second roll resulted in 7, the player loses. 

if (sum 7) 
{ 

// Display losing message in the label. 
l.setText ( "You lose. " ) ; 

// Set the firstRoll flag variable to true so that the 

// program "knows" the next roll is the first roll of a new 

// game. 

firstRoll = true; 

} 

// Execution now leaves the actionPerformedO method. 



Method: main() 

This is the entry-point to the Craps program. When you type 
java Craps, the main() method is called. 

Arguments: 

args - a String array of command line arguments, where each 
argument is stored in a separate array element 



Return : 



03 71710_CH01 11/21/01 11:32 AM Page 30 




30 Chapter 1: Introducing Java 

Listing 1.1: continued 

// nothing 

// ============= 



public static void main (String [] args) 
{ 

// Create a Craps object and call its constructor with a "Craps" 
// String argument. 

new Craps ( "Craps" ) ; 

} 

} 

// Class: Die 

// 

// This class provides the blueprints for a die. 
/ / ============================================= 

class Die extends Canvas 
{ 

// Initially, a die is displayed with zero spots. 



private int nSpots = 0; 



Method: draw() 

Draw a die with a specific number of spots on its visible 
surface . 

Arguments : 

nSpots - number of spots to draw on die's visible surface. 

Return : 

nothing 



public void draw (int nSpots) 
{ 

// Assign nSpots argument value to nSpots instance variable, 
this. nSpots = nSpots; 
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Listing 1.1: continued 

// Tell Java's Abstract Windowing Toolkit (AWT) to call the 
// paintO method, so that this die will be drawn. 

repaint (); 



Method: getPref erredSize( ) 

When the AWT is laying out components on the screen, it calls 
each component's getPreferredSize( ) method to return the size at 
which the component prefers to be displayed. 

Arguments: 

none 

Return: 

a Dimension object that contains the preferred width and height 
-- both values are measured in pixels 



public Dimension getPref erredSize () 
{ 

// Create a Dimension object. The leftmost 30 represents the 

// width and the rightmost 30 represents the height. The 

// address of this object is returned to the caller -- the AWT. 

return new Dimension (30, 30); 



Method: paint () 

Paint the die's appearance on the screen. This method is called 
by the AWT at various times. 

Arguments: 

g - the address of a graphics context object (which contains 
methods for working with graphics) 



Return : 
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Listing 1.1: continued 

// nothing 

// 

public void paint (Graphics g) 
{ 

// Obtain the width and height of this component. These values 
/ / are in pixel units . 

int width = getSize (). width; 
int height = getSize (). height; 

// Draw a rounded rectangle outline in the default color black 
// around the die. The upper-left corner is (0, 0) and the 
// lower-right corner is (0 + width -1,0-1- height - 1). The 
// width and height of each corner arc are 5 units each. 

g.drawRoundRect (0, 0, width - 1, height - 1, 5, 5); 

// Calculate the center of the rectangular region in which the 
// die is displayed. 

int cx = width / 2; 
int cy = height / 2; 

// Draw an appropriate number of spots on the die's visible 
// surface. This number depends on the value saved when the 
// draw() method was called. The fillOval() method is called 
// to draw each spot as a solid circle in the default color 
// black. The first two method arguments describe the 
// upper-left corner of the oval's bounding rectangle, and the 
// final two arguments describe the width and height of this 
// rectangle. 

switch (nSpots) 
{ 

case 1: g.fillOval (cx - 2, cy - 2, 4, 4); 
break; 

case 2: g.fillOval (2, 2, 4, 4); 

g.fillOval (width - 6, height - 6, 4, 4); 
break; 



case 3: g.fillOval (2, 2, 4, 4); 

g.fillOval (cx - 2, cy - 2, 4, 4); 



03 71710_CH01 11/21/01 11:32 AM Page 33 




Java Programs 33 



Listing 1.1: continued 

g.fillOval (width - 6, height - 6, 4, 4); 
break; 

case 4: g.fillOval (2, 2, 4, 4); 

g.fillOval (width - 6, 2, 4, 4); 
g.fillOval (2, height - 6, 4, 4); 
g.fillOval (width - 6, height - 6, 4, 4); 
break; 

case 5: g.fillOval (2, 2, 4, 4); 

g.fillOval (width - 6, 2, 4, 4); 
g.fillOval (cx - 2, cy - 2, 4, 4); 
g.fillOval (2, height - 6, 4, 4); 
g.fillOval (width - 6, height - 6, 4, 4); 
break; 

case 6: g.fillOval (2, 2, 4, 4); 

g.fillOval (width - 6, 2, 4, 4); 
g.fillOval (2, cy - 2, 4, 4); 
g.fillOval (width - 6, cy - 2, 4, 4); 
g.fillOval (2, height - 6, 4, 4); 
g.fillOval (width - 6, height - 6, 4, 4); 

} 

} 

} 

Notice the first line of source code — the line consisting of // Craps, java. 
The / / characters indicate documentation. Those characters and all charac- 
ters to the right of / / (to the end of the line) are ignored by the compiler: 
they do not contribute to the Craps application beyond providing human- 
readable text that explains the source code's purpose. // Craps, java identi- 
fies Craps, java as the file containing the application's source code. Although 
it isn't necessary to specify / / Craps . j ava, I am in the habit of stating the 
filename in which source code is saved at the start of that source code, and 
you'll see that practice followed in all source code (except for code frag- 
ments) appearing in this book. 

Compilation 

You can download Craps . j ava with the rest of this book's source code from 
the Que Web site. (See this book's introduction for the location of that source 
code.) After you've downloaded Craps . j ava, you will need to compile the 
source code into its equivalent bytecodes before you can run Craps. 
(If you prefer, you can key in all of the source code to Craps, using your 
favorite text editor, and then save the source code to a file called Craps, java.) 
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Let's assume you installed SDK 1.4 on the Windows platform. Let's also 
assume that you've started an MS-DOS command window and are now at 
the MS-DOS command line. Furthermore, let's assume that command line 
shows your current location to be the c: \iclkl .4\pnoiects\Craps directory. 



TIP 

If you are not familiar with working at the iVIS-DOS command line, you can ensure that 
the preceding directories exist and that you are located in the Craps directory by exe- 
cuting the following commands (in the specified order): First, type c: (and press the 
Enter key) at the IVIS-DOS command line to ensure that the C drive is the current drive. 
Then, type cd c: \ jdk1 .4 (and press the Enter key) to ensure that the jdk1 .4 direc- 
tory is the current directory (After issuing that change directory command, your MS- 
DOS command prompt should display as c: \idk1 .4\>.) Then, type md projects (and 
press the Enter key) to make a projects directory under c: \ jdk1 .4. Continuing, type 
md prQjects\Craps (and press the Enter key) to make a Craps directory under 
c:\jdk1 .4\ projects. Finally, type cd proj ects\Craps (and press the Enter key) to 
change to the Craps directory. 



To compile Craps, java, use the javac.exe compiler tool and issue the com- 
mand line that's shown in Figure 1.3 — javac Craps, java. Make sure to 
include the . j ava file extension. Otherwise, the compiler will issue an error 
message. 



CAUTION 

Failure to specify the . java file extension when compiling a Java source code with the 
SDK's Java compiler is a frequent source of error. 



<DIR> 16/02/01 17:36 . 

<DIR> 16/02/01 17:35 .. 

CRAPS~1 3AV 16,115 11/02/01 11 : 23 Craps . java 

1 fileCsJ 16,115 bytes 

2 dirCs) 2,011.71 MB free 

C : \jdkl. 1\projects\Craps> javac Craps .java 

C : \jdkl. 1\prajects\Craps>di r 

Volume in drive C has no label 
Volume Serial Wumber is 13SO-OFE3 
Directory of C:\jdkl.1\projects\Craps 

<DIR> 16/02/01 17:36 . 

<DIR> 16/02/01 17:36 .. 

CRAPS~1 3AV 16,115 11/02/01 11 : 23 Craps . java 

CRAPSj-l CLA 118 16/02/01 17:46 Crapsl 1. cl ass 

CRAPS~1 CLA 1,822 16/02/01 17 : 16 Craps . cl ass 

DIE-1 CLA 1,166 16/02/01 17:46 Die. class 

1 fileCs) 19,551 bytes 

2 dirCs) 2,011.73 MB free 

C:\idkl.1\proiects\Craps> 



Figure 1.3: The Java compiler tool javac.exe is started from the MS-DOS 
command line to convert Craps . java into three class files: Craps .class, 
Craps$1 .class, and Die. class. 



03 71710_CH01 11/21/01 11:32 AM Page 35 




Java Programs 35 



As Figure 1.3 shows, the compiler creates three class files: Cnaps. class, 
Craps$l .class, and Die. class. Craps, class is the starting class file of our 
application because it contains a special entry-point method called main ( ) . 
Craps$l .class contains the code for an anonymous inner class. The 
compiler generated that class as a result of the addWindowListener(new 
WindowAdapter( ) { ... }) ; logic in Craps, java. (Don't worry about what 
anonymous inner classes are because I explore that concept in a later 
chapter.) Finally, Die. class contains logic to create and display a graphical 
component that looks like a die. 



NOTE 

Because this book does not explore graphics and GUIs, you will need to refer to 
another book to learn more about those topics. One book to consider is Que's Special 
Edition Using Java 2 Standard Edition (ISBN 0-7897-2468-5). 



If you encountered compilation problems, you might have incorrectly 
installed SDK 1.4 (and not specified jdkl .4\bin in your PATH), typed an 
incorrect keystroke when entering the source code, not saved that source 
code to a file called Craps . j ava, or forgotten to include . j ava when compil- 
ing. Carefully review your installation, the source code, and the way in 
which you compiled that code — and try again. If you still have problems, 
send an e-mail to ITworld.com's Java Beginner discussion forum, and some- 
one will be happy to help you get the code working. 

✓ To obtain the Java Beginner discussion forum address, see "FAQs, Forums, and 
Newsgroups," p. 794. 

Execution 

Assuming you've successfully compiled Craps . j ava, it's time to execute that 
application. To run Craps under Windows, use the SDK's java.exe applica- 
tion launcher tool and issue the command line, Java Craps. 



CAUTION 

When running an application with java.exe, do not specify the .class file extension. 
Also, remember to use exact case when specifying the class name. 

Do not include the .class file extension when specifying the command line that runs 
an application, like Craps. For example, if you specify a java Craps. class command 
line, the j ava . exe application launcher tool will display an error message when it 
encounters .class. Drop .class from the command line, and java.exe will run your 
application. 
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Because Java is a case-sensitive language, pay careful attention to the case of the 
class name that you specify after java on the command line. The case of that name 
must match the case of the starting class filename. Otherwise, java.exe displays an 
error message and refuses to run the application. For example, specifying java craps 
on the command line results in an error message, because craps does not match 
Craps — the name of the starting class file. 



Figure 1.4 shows the main window of the Craps apphcation. That window 
displays the word Craps in its title bar. You can see a pair of empty rectangles 
with slightly rounded corners in the upper area of the window. Each empty 
rectangle represents a die. The side facing you corresponds to the topmost 
face of a thrown die. No spots appear on those faces until the first time you 
click the Roll button (located in the lower area of the window). To see what 
might happen when you click Roll for the first time, check out Figure 1.5. 




Figure 1.4: The Java application launcher tool java.exe is started from the 
Windows command line, to run Craps. That results in Craps' main window 
being displayed. 




Figure 1.5: The Craps window shows whether you win or lose when playing 
Craps. 



CAUTION 

After typing java Craps, you might receive a message that results from either a source 
code problem or an incorrect environment setting. 

The message Exception in thread "main" j ava . lang . NoSuchMethodError : main 
indicates that you haven't properly specified the main{ ) method in the Craps class. 
Make sure to specify that method as public static void main (String [] args). 



The message Exception in thread "main" j ava . lang . NoClassDef FoundError : 
Craps indicates that you have a CLASSPATH environment variable which doesn't include 
the current directory. Append ; . (assuming Windows) to CLASSPATH to fix the problem. 
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When you're finished playing Craps, cHck the small button with the X label 
on the right side of the title bar. The Craps window closes, and you are 
back at the Windows command line. (Of course, that assumes you are run- 
ning Craps in a Windows environment.) 



TIP 

In a Microsoft Windows environment, when tine IVIS-DOS command window is tine active 
window, if your application seems to lock up (usually because of a logic problem), press 
the Ctrl+C key combination. The frozen application will immediately terminate. 



If you've been able to compile and run Craps, congratulations are in order. I 
hope you're starting to feel excited by what Java can do. You'll get to see 
many more applications in this book. For now, let's explore the structure of 
applications. 

Application Structure 

Look carefully at the Craps source code in Listing 1.1. That source shows 
that Craps consists of several classes. Furthermore, one of those classes 
contains an entry-point method called main ( ) with the following signature: 
public static void main (String [] args) 

The main ( ) method is the first method to be called when Craps runs. 
Interpret its signature as follows: The word public makes main() accessible 
to the SDK's application launcher program (or the equivalent code in 
another development tool) that runs Craps. The word static implies that 
an object doesn't need to be created before Craps can start running. Finally, 
the word void means that main ( ) does not return a value to its caller. 

Any Java application can be passed a sequence of command-line arguments 
to process. Those arguments make it possible to customize the program 
without having to recompile the source code. For example, a file viewer 
application is more useful when passed an arbitrary filename as an argu- 
ment than if a filename is specified in the file viewer's source code. 
Arguments passed to a Java application are represented as an array of 
String objects. (The [ ] characters identify an array.) Each array must have 
a name, and args has been chosen to identify the arguments array in Craps' 
mainO method. There is nothing special about args: it could just as easily be 
renamed to f red or something else. 

The important thing to keep in mind about an application is that it must 
contain at least one starting class with a main ( ) method that matches the 
aforementioned signature. You'll learn more about applications as you work 
your way through the next several chapters. 
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Java Versus C++ 



In the beginning (around 1970), Dennis Ritchie created a language called C. 
In time, C gave birth to a language called C++, and C++ gave birth to the 
Java language. Because of their common C ancestry, Java and C++ are 
"close cousins" (as far as languages go). However, even though there are 
many similarities, there are also many differences that set those languages 
apart. (A few differences were pointed out to you, earlier in this chapter.) If 
you are new to Java but come from a C++ background, you will want to 
read this section: It will help you get a feel for Java (based on your C++ 
knowledge) by comparing two source code listings of the same program, by 
exploring some of the similarities shared by C++ and Java, and by explor- 
ing some of their many differences. If you do not come from a C++ back- 
ground, feel free to ignore this section. 



NOTE 

Some time ago, Microsoft announced the C# (pronounced C-sharp) language as a lan- 
guage designed to compete with Java for market share. During November and 
December 2000, JavaWorld magazine published a two-part series that compares Java 
and C#. Part 1 of that C#: A language alternative or just J — ? article is located at 
http : / /www. j avaworld . com/ j avaworld/ j w- 1 1 -2000/ jw- 1 122-csharp1 .html and 
Part 2 is located at http: / /www. j avaworld .com/ j avaworld/ jw - 12 -2000/ jw- 1221 - 
csharp2 . html . If you see yourself working with C# (in the future) or are simply curious 
about how it compares with Java, consider reading those articles (after you have 
worked your way through this book and are better acquainted with Java). 

The acceptance of C# has caused some developers to wonder if Java will be replaced 
with that technology. Personally, I doubt that will happen. I say that because C# is 
designed for exclusive use on Microsoft's platforms (by way of .NET), whereas Java is 
designed for use on all kinds of platforms (by way of the JVM). Also, the vehicle indus- 
try supports many companies that offer similar products, and their products tend to sur- 
vive. Why should the computer industry be any different? 



Two Listings of the Same Program 

One of the best ways to get comfortable with a new language is to study a 
pair of source code listings to the same program. One listing presents 
source code written in a familiar language (like C++), whereas the other 
listing presents source code written in the new language. To demonstrate, 
I've designed a simple program called Employee. In that program, an 
Employee object is created with a specific salary. Furthermore, the salary is 
retrieved from the object and output. 
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^ \ I / 

EXAMPLE 



Listing 1.2 presents Employee's C++ source code. 

Listing 1.2: Employee. cpp. 

// Employee. cpp (C++ Employee program) 

// This program creates an Employee object initialized to a specific 
// salary and then calls an Employee member function to retrieve this 
// salary. The salary (and some text) is output to the standard 
// output device and the object is destroyed. 

// The following #include preprocessor directive tells the C++ 

// preprocessor to include the contents of the lOStreams header file 

// prior to compilation. 

#include <iostream.h> 



/ Class: Employee 

/ 

/ This class describes the structure of Employee objects. In this 

/ trivial class, an Employee object consists of a salary and nothing 

/ else. 



class Employee 
{ 

// All members declared after private: cannot be accessed outside 

// the Employee class. 

private : 

// The Employee's salary is stored in the salary variable, 
double salary; 

// All members declared after public: can be accessed outside the 
// Employee class. 

public: 



// Member Function: Employee() 

// 

// Construct an Employee object by initializing its salary 

// variable. 

// 
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Listing 1.2: continued 

// Arguments: 

// 

lis- the Employee's salary 



Employee (double s) 
{ 

salary = s; 

} 

// Include only the getSalaryO member function header to prevent 
// this member function from being inlined -- a C++ optimization 
// step. 

double getSalary () ; 

}; 

/ / ======================================== 

II Member Function: getSalaryO 

// 

// Return the value of the salary variable. 

// 

// Arguments: 

// 

// nothing 

// 

// Return: 

// 

// salary variable's value 

/ / ======================================== 

double Employee: : getSalary () 
{ 

return salary; 

} 

// ================================================================== 

II Function: main() 

// 

// main() is the entry-point into this program. When Employee runs, 
// main() is called (after internal initialization and any registered 
// startup functions are called) before anything else. 

// 

// Arguments: 
// 
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isting 1.2: continued 

/ argc - count of command line arguments passed to this program 

/ 



/ argv 

/ 

/ 



address of an array of C++ strings, where each string 
contains a command line argument. (Employee does not use 
this feature. ) 



/ 

/ Return: 

/ 

/ nothing 
/ ======== 



void main (int argc, char *argv []) 
{ 

// Create an Employee object with a salary that's initialized to 
// 30000.0 and return its address, which subsequently assigns to 
// Employee pointer variable e. 

Employee *e = new Employee (30000.8); 

// cout is a C++ object that controls data output to the standard 

// output device. The setf() and precision() member functions 

// establish formatting. In this example, setf() "tells" cout that 

// the next numeric data item is a floating-point value and 

// precisionO "tells" cout to display one digit of precision to 

// the right of the decimal point. 

cout.setf (ios: :floatfield) ; 
cout. precision (1); 

// Output all characters between the quote characters " and ". 

// Follow this output with the contents of the salary variable (by 

// calling getSalaryO) and a newline character (\n). 



cout « "Salary 



« e->getSalary ( ) « ' \n ' 



// Explicitly destroy the Employee object. (In contrast to C++, 
// Java takes on this responsibility in a Java program.) 



delete e; 



// Output (when run): Salary = 30000.0 

1 1 



03 71710_CH01 11/21/01 11:32 AM Page 42 




42 Chapter 1: Introducing Java 




EXAMPLE 



Assuming you are a veteran C++ developer, the C++ source code should be 
easy to understand. The only thing you might wonder about is the superflu- 
ous use of private: in the Employee class. Because a C++ class defaults to a 
private access level, the only reason for specifying private: is to emphasize 
salary as being private to Employee. 

Now that you've seen Employee's C++ code, look at the equivalent Java 
code — in Listing 1.3. 

Listing 1.3: Employee. java. 

// Employee. java (Java Employee program) 

/ This program creates an Employee object initialized to a specific 
/ salary and then calls an Employee method to retrieve this salary. 
/ The salary (and some text) is output to the standard output device. 

/ Class: Employee 

/ 

/ This class describes the structure of Employee objects. In this 
/ trivial class, an Employee object consists of a salary and nothing 

/ else. 

/ 

class Employee 
{ 

// The Employee's salary is stored in the salary variable. Because 
// this variable is declared private, salary cannot be accessed 
// outside Employee. 



private double salary; 



// Method: Employee () 

// 

// Construct an Employee object by initializing its salary 
// variable. 

// 

// Arguments: 

// 

// s - the Employee's salary 

/ / 

Employee (double s) 
{ 

salary = s; 

} 
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Listing 1.3: continued 

/ / ======================================== 

II Method: getSalary() 

// 

// Return the value of the salary variable. 

// 

// Arguments: 

// 

// nothing 

// 

// Return: 

// 

// salary variable's value 

/ / ======================================== 

double getSalary () 
{ 

return salary; 

} 

// ================================================================ 

II Method: nain() 

// 

// main() is the entry-point into this program. When this program 
// runs, main{) is called (after any optional class initialization) 
// before anything else. 

// 

// Arguments: 

// 

// args - an array of Java String objects, where each String object 
// contains a command line argument. (Employee does not use 

// this feature. ) 

// 

// Return: 

// 

// nothing 

// ================================================================ 



public static void main (String [] args) 
{ 

// Create an Employee object with a salary that's initialized to 
// 30000.0 and return its address, which subsequently assigns to 
// Employee reference variable e. 



Employee e = new Employee (30000.0); 
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Listing 1.3: continued 

// Output all characters between the quote characters " and ". 

// Follow this output with the contents of the salary variable 

// (by calling getSalary( ) ) . {A newline character is 

// automatically output after all other characters.) 

System. out. println ("Salary = " + e.getSalary ()); 

} 

} 

// Output (when run): Salary = 30000.0 
/ / =================================== 

Listings 1.2 and 1.3 present a few similarities. For example, the reserved 
words class, private, double, public, return, void, and new appear in both 
listings (and mean the same things in both languages). The use of brace 
characters { and } is also consistent across C++ and Java. 

Listings 1.2 and 1.3 also present some differences. For example, Listing 
1.2's #include preprocessor instruction is used to insert the contents of a file 
called iostream.h into the source code prior to compilation. Java does not 
support preprocessor instructions of any kind. As a second difference exam- 
ple, C++ marks off areas of a class as private (the default), public, and so 
on. C++ accomplishes that task through the use of private:, public:, and so 
forth. Class members appearing after private: are considered private; class 
members appearing after public: are considered public; and so on. In con- 
trast, Java doesn't support that concept. Instead, each class member can be 
individually prefixed with private, public, or another reserved word to spec- 
ify its visibility outside the class in which the member is declared. In a 
third example, both programs present main ( ) as their entry points. C++'s 
main ( ) function is not declared in a class, whereas Java's main ( ) method is 
declared in a class. Also, each main ( ) signature is declared differently. A 
final example shows Listing 1.2's use of cout to output data to the standard 
output device, whereas Listing 1.3 uses System. out. println () to perform the 
same task. 

✓ To learn more about System . out . println( ) and the standard output device, see "Working 
with Streams," p. 634. 

Language Similarities 

Java and C++ are similar in many areas. You've already seen a few similar- 
ities. Rather than attempt to itemize each and every similarity, I've orga- 
nized a variety of language similarities into four categories: reserved words, 
types, operators, and statements. Those categories are far from exhaustive. 
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Reserved Words 

Java and C++ implement many of the same reserved words, including 
double, while, public, and class. Those words mean the same thing in 
either language. 

✓ To learn more about Java's reserved words, see "Reserved Words and Keywords," p. 59. 
Types 

Java and C++ support character, double-precision floating-point, floating- 
point, integer, long integer, and short integer types. Those types are repre- 
sented in source code by way of the char, double, float, int, long, and short 
reserved words. 

✓ To learn more about Java's types, see "Types," p. 59. 
Operators 

Many operators — such as additive C+) and conditional (? :) — found in Java 
and C++ are identical. When evaluating expressions containing those oper- 
ators, Java and C++ use identical precedence rules. 

✓ To learn more about Java's operators, see "Operators," p. 84. 
Statements 

Java and C++ support variable declaration, assignment, decision, iteration, 
and other statements using identical syntax. Each statement in one lan- 
guage behaves in a manner consistent with its counterpart in the other lan- 
guage. 

✓ To learn more about Java's statements, see "Statements," p. 109. 

Language Differences 

To complement the similarity categories, I've created identical categories 
that review some differences between Java and C++. Having an opportu- 
nity to view each category's differences (in addition to similarities) gives a 
much clearer picture of how Java and C++ compare. 

Reserved Words 

Java provides a few of its own reserved words, such as strictf p, transient, 
synchronized, and extends. (The extends reserved word is used in place of 
C++'s colon character to more descriptively indicate inheritance.) Further- 
more, Java does not support some of C++'s reserved words — enum, typedef , 
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register, and delete come to mind. (Java does not support the delete 
reserved word because Java takes on the responsibihty of destroying 
objects via its garbage collection mechanism.) By the way, Java reserves 
const and goto — which are also found in C++ — but doesn't implement them. 

Types 

Java and C++ define the character type and use the same char reserved 
word to identify that type in source code. However, the size of the character 
type's implementation under C++ defaults to 8 bits and character values 
are considered (by default) to be interpreted as 8-bit signed integers in 
arithmetic operations. In contrast, Java defines the character type to have 
an unsigned 16-bit implementation. 

Java's various integer types have fixed sizes that are the same on every 
platform where Java runs. In contrast, C++'s integer types have sizes that 
fluctuate among platforms. For example, Java's integer type (represented in 
source code as int) is fixed at 32 bits, whereas C++'s integer type can vary 
from 16 bits to 64 bits and beyond. 

Unlike Java, early versions of C++ did not support the Boolean (true/false) 
type. Instead, because C++ considers the integer 0 to represent false and 
any non-zero integer to represent true, integer values are used to make 
decisions. As a result, it is not uncommon in C++ to specify the decision 
expression of an iteration statement (such as a while loop statement) as 
follows: 

int X = 10; 
while (x--); 

That X - - decision expression is illegal in Java because the expression used 
to terminate the while loop statement must evaluate to a Boolean. The 
preceding code fragment can be corrected for use in Java as follows: 

int X = 10; 
while (x- - > 0) ; 

In addition to the aforementioned basic type differences, Java does not 
support C++'s pointer (at least not directly), structure, and union types. 

Operators 

Although Java and C++ share many operators, there are a number of dif- 
ferences. For example, Java introduces a few new operators (such as 
instanceof and »>) and does not support some of C++'s operators (such as 
sizeof and * — pointer dereference). Also, Java overloads the additive opera- 
tor (+) so that it can be used for both addition and string concatenation. 
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Furthermore, Java does not support developer-specified operator over- 
loading. That support is not provided because Java's language designers 
felt operator overloading would be too burdensome for newcomers to learn. 

Statements 

Although Java reserves goto, Goto statements are not implemented. That 
leads to an interesting problem. Suppose code is executing inside the inner- 
most of several nested loops and must break out of all loops when some 
condition is reached. How is that task accomplished? In C++, you could use 
the Goto statement to "tell" the code to break out of all loops. However, that 
approach isn't clean because it can bypass variable declarations. Java 
doesn't support Goto but allows a label to be attached to the outermost loop 
(to be broken out of) and allows that label to be specified as an argument to 
the Break statement. That approach accomplishes the same thing as a Goto 
statement, but is much cleaner. As with Break, Java also supports specifying 
a label as part of its Continue statement. 



What's Next? 



Now that you've had a taste of Java, it's time to begin learning that lan- 
guage. The next chapter starts teaching Java by focusing on a few non- 
object-oriented language features that range from Unicode to types. Is a 
reserved word the same as a keyword? To find an answer to that question, 
you'll have to read the next chapter. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 

NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 



Reviewing It 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. What are five features that Java uses to help you write "bug-free" code? 

2. Why do you think Sun's Java compiler requires you to specify a . j ava 
file extension in addition to the filename? 




REVIEW 
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3. Was Java designed with the World Wide Web in mind? 

4. Why is it a good idea to completely uninstall a previous version of a 
Java JDK/SDK before installing a new version? 

5. What is an advantage and a disadvantage in using Sun's SDK 
command-line tools over an IDE? 

6. How does an application differ from an applet? 

7. Suppose you attempt to run Craps but receive an error message 
telling you that a class cannot be found. How do you correct this 
situation? 

8. Why does Java not include a sizeof operator? 

9. Java's primitive types have well-defined sizes. How do well-defined 
primitive type sizes promote portability? 



Checking It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. What mechanism does Java use to destroy objects? 

a. Java's delete reserved word 

b. A destructor 

c. Garbage collection 

d. Java doesn't destroy objects (the developer is responsible) 

2. Which of the following reserved words is specific to Java? 

a. new 

b. synchronized 

c. enum 




d. const 
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3. An application's main ( ) method must be declared using what? 

a. The void reserved word 

b. The static and void reserved words 

c. The public, static, and void reserved words 

d. None of the above 

4. Which of the following Java types is considered unsigned? 

a. Boolean 

b. integer 

c. character 

d. None of the above 

5. What was Java designed to be? 

a. A language 

b. A virtual machine 

c. A library of classes 

d. All of the above 

6. How does Java achieve robustness? 

a. True arrays with bounds checking 

b. No pointers 

c. Stricter type checking than that found in C++ 

d. All of the above 

7. In what year did Sun release the first Java Development Kit? 

a. 1991 

b. 1995 

c. 1994 

d. None of the above 

8. What part of the JVM is responsible for ensuring all bytecodes are 
valid? 

a. Class loader 

b. Interpreter 
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c. Bytecode verifier 

d. All of the above 

9. Standalone programs are created from which of the following program 
categories? 

a. JavaBeans components 

b. Applets 

c. Servlets 

d. Applications 

10. Which of the following operators is overloaded by Java? 

a. + 

b. »> 

c. ?: 

d. None of the above 
True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. Java supports multiple implementation inheritance. 
True/False 

2. A Java application contains a class with a main ( ) method. 
True/False 

3. Unlike C++, Java manages object destruction. 
True/False 

4. Both Java and C++ support structured programming. 
True/False 

5. To run a Java application with java.exe (under Windows) or its equiv- 
alent (on other platforms), you must include the .class file extension. 

True/False 

6. To compile a Java application with j avac . exe (under Windows) or 
its equivalent (on other platforms), you must include the . j ava file 
extension. 

True/False 
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7. Java supports labeled Break and Continue statements. 
True/False 

8. Java 2 Enterprise Edition is used to develop Java programs that run 
on consumer devices (such as cell phones). 

True/False 

9. The Java Native Interface connects Java code to non-Java code. 
True/False 

10. A JIT compiler creates a native executable. 
True/False 



APPLY 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. Modify Craps . j ava so that both dice are displayed using cyan dots 
instead of black dots. (Hint: All you need to do is place the following 
code in a certain place: g.setColor (Color. cyan) ;.) 

2. Modify employee . j ava so that it prints your name when the program 
starts. 

3. Modify employee . j ava so that each employee can have a name. The pro- 
gram should print out the name in addition to salary. 
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From Unicode to Types 

When learning a new computer language, it is best to start with simple lan- 
guage features. This chapter explores what are probably the simplest of 
Java's language features. Specifically, Chapter 2 explores Java's support for 
the Unicode character set, as well as comments, identifiers, and types. You 
will not find the source code to any program in this chapter, because you 
must learn additional language features (in subsequent chapters) before 
you can begin writing Java programs. Instead, think of Chapter 2 as pro- 
viding a theoretical foundation on which to build. Future chapters, which 
discuss more advanced language features, build on that foundation. 
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Unicode 



It is fitting to begin exploring language features by discussing Java's sup- 
port for Unicode, because Unicode lies at the "heart" of Java programs. 
When a Java program manipulates characters and strings of characters, 
that program manipulates Unicode numbers. Unicode — a universal charac- 
ter set that defines characters used in major written languages (such as 
Japanese, Chinese, French, Arabic, English, and so on) — maps a 16-bit inte- 
ger number to a symbol, and each mapping is known as a character. As an 
example, Unicode maps number 12,387 to the Hiragana letter shown in 
Figure 2.1. 

O 

Figure 2.1: Unicode defines many characters, including the Hiragana letter 
that is mapped to number 12,387. 



NOTE 

For those not familiar, the word bit is a contraction of binary digit. It represents either a 
1 or a 0 and is a computer's smallest unit of storage. Bits are combined into larger 
entities (such as bytes and 32-bit bit sequences) so that they can store other kinds of 
data. For example, combining 16 bits into a 16-bit bit sequence makes it possible to 
store, in that bit sequence, any one of 65,536 integer numbers. (What is an integer? 
An integer is a whole number — it does not have a fractional part.) 



In contrast to Unicode, the older ASCII character set maps 128 7-bit integer 
numbers to 128 English-oriented symbols, such as mapping number 65 to 
capital letter A. Because ASCII is limited to the English language, Unicode 
was designed to supersede ASCII. Rather than ignore the value of ASCII, 
the designers of Unicode chose to make Unicode backward-compatible with 
ASCII by reserving the first 128 Unicode characters as ASCII characters. 
That is why Unicode number 65 also maps to capital letter A. 

Even though Unicode lies at the "heart" of Java programs, Java source code 
is often specified by means of some ASCII-based editor. To increase the 
range of characters that can be entered using the editor's ASCII character 
set, Java introduces the Unicode escape sequence — an ASCII character 
sequence that represents a Unicode number by using \uxxxx, where each x 
represents a hexadecimal digit. For example, to specify the European 
Union's monetary symbol — the euro — using an ASCII-based text editor, 
enter the \u20ac Unicode escape sequence into your source code. Figure 2.2 
illustrates the euro symbol. 
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Figure 2.2: Another symbol defined by Unicode is the euro. That symbol is 
mapped to \u20ac (8,364 decimal). 

Before source code is compiled, a Java compiler checks that code to see 
whether it's composed of Unicode numbers. If that is the case, compilation 
immediately begins. However, if the compiler finds that code to be com- 
posed of ASCII numbers, it translates those numbers to their Unicode 
equivalents by prefixing nine zero bits to each 7-bit ASCII number — with 
the sole exception of Unicode escape sequences. When a Unicode escape 
sequence is encountered, the six ASCII numbers representing that 
sequence are translated into a single 16-bit Unicode number. When transla- 
tion completes, compilation begins. 

Later in this chapter (as well as the next chapter), you will see examples 
that illustrate the use of Unicode escape sequences to enhance your source 
code — especially if English isn't your first language. To learn more about 
Unicode, visit the official Unicode Web site (http: //www. Unicode. org). 

NOTE 

Version 1.4 of the Java 2 Platform, Standard Edition supports Unicode version 3.0. 
At tine time this chapter was written, Unicode 3.1 became the latest version of the 
Unicode specification. That new specification raises future problems for Java because it 
defines more than 65,536 symbols; however, Java's character type isn't capable of rec- 
ognizing more than 65,536 symbols. How might Sun solve that problem in future Java 
releases? One solution might be to introduce a new 32-bit character type (represented 
in source code with a new reserved word — such as char32) that is capable of recogniz- 
ing more than four billion characters. (Other changes, such as a new String type to 
handle larger characters, will also be needed.) Whatever future changes must be made 
to Java so that Unicode version 3.1 is supported, be assured that Sun will do what's 
necessary to prevent existing source code from breaking. 



Comments 



It is a very good idea to document your source code as you write it. You 
should also update that documentation whenever you change the source 
code. Not only will documentation help others understand your code, but it 
will also help you remember what was going through your mind if and 
when you revisit that code at some future time. 

Documenting Java source code is accomplished by taking advantage of the 
comment feature. The symbols and textual information that you specify 
as a comment are completely ignored by the Java compiler. As a result, 
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comments don't result in the compiler generating bytecodes. Java recog- 
nizes single-line comments and multiline comments. 

Single-line Comments 

A single-line comment spans a single line of text. That style of comment is 
introduced with the / / characters. All characters that follow / / (including 
/ / ) are ignored by the compiler. 

The following code fragment demonstrates a single-line comment: 

int count = 1; // Initialize employee name count variable. 

EXAMPLE Multiline Comments 

In contrast to the single-line comment, a multiline comment spans multiple 
lines. That style of comment begins with the / * characters and ends with 
the */ characters. All characters from /* to */ (inclusive) are ignored by the 
compiler. Multiline comments are normally used to comment out portions of 
source code during testing and debugging. 

The following code fragment demonstrates a multiline comment: 

/* This multiline comment can include /*, // 
and /**; and spans multiple lines. */ 

EXAMPLE 

NOTE 

If you've studied Chapter I's Craps application source code, you might be wondering 
why I chose to use the single-line comment style for comments spread across multiple 
lines. There was no special reason. I just felt like it. (There is no rule that says you 
have to use multiline comments if you feel like using single-line comments.) 

Unlike C+H-'s support for multiline comments, you cannot nest Java's multi- 
line comments. The compiler generates errors if it encounters nested multi- 
line comments in your source code. 

The Java compiler displays an error message when it encounters the follow- 
ing nested multiline comment: 

/* 

EXAMPLE /* This comment is nested. */ 

*/ 

CAUTION 

An attempt to compile source code containing nested multiline comments results in 
one or more compiler error messages. 
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Documentation Comments 

As you learn more about Java, you will encounter a third style of comment — 
the documentation comment. Documentation comments are used to specify 
program documentation that can be extracted by a special tool, which con- 
verts that documentation to either HTML or some other format. 

A documentation comment is a multiline comment that begins with the /** 
characters and ends with the * / characters. The compiler treats that com- 
ment as a multiline comment because of the initial /*. The * immediately 
following / * differentiates a documentation comment from other multiline 
comments. 

The following code fragment demonstrates a documentation comment: 

/** This is a documentation connent. Although not shown, 
documentation comments can contain special 
instructions that are used by the Javadoc tool when 
producing either HTML-formatted documentation or some 
other kind of formatted documentation. */ 

A source file containing documentation comments can be passed to the 
SDK's Javadoc tool for processing. That tool extracts the contents of each 
documentation comment and (by default) merges those contents with 
HTML elements, which Javadoc subsequently places into several HTML 
files: That is what Sun has done with its own class library. The resulting 
documentation can be viewed by a Web browser. 



Identifiers 



Source code contains the names of various language entities — variables, 
classes, methods, interfaces, packages, and labels. Each name is known as 
an identifier because it identifies one of those entities. 

An identifier consists of uppercase letters (a through z, or equivalent upper- 
case letters in other languages), lowercase letters (a through z, or equiva- 
lent lowercase letters in other languages), digits (0 through 9, or equivalent 
digits in other languages), and a handful of special characters (such as the 
dollar sign ' $ ' and underscore '_' , or equivalents in other languages). Also, 
the first character must be a letter, a dollar sign (or other currency charac- 
ter), or an underscore (or other connecting punctuation character). Any 
other character will result in a compiler error message. The number of 
characters constituting an identifier — the identifier's length — is limited 
only by the length of the line in which the identifier appears. 
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EXAMPLE 




EXAMPLE 



TIP 

It's often preferable to choose identifier names with shorter rather than longer lengths. 
After all, why spend time typing extremely long names? On the flip side, don't always 
choose extremely short names because your source code will lose meaning. For exam- 
ple, do you really want to type myVeryOwnAccountBalanceAtMyFavoriteBank over and 
over? You could shorten that identifier to myAB, but that isn't meaningful. Instead, you 
can strike a balance between length and meaning by choosing myAcctBal. (Identifiers 
with meaningful names work in partnership with comments to document source code.) 

Java considers the following sample identifiers to be valid: 

• $amount 

• _total 

• salary 

• countere 

• firstName 

• number_of_tickets 

• \u3063\u20ac 

Figure 2.3 illustrates the valid identifier specified by \u3063\u20ac. 

Figure 2.3: Java considers an identifier beginning with a Hiragana letter to 
be just as valid as if that identifier began with an English letter 

CAUTION 

Although it is legal to begin an identifier with either a currency character or a connecting 
punctuation character (such as the underscore). Sun advises against that practice in its 
Code Conventions for the Java Programming Language document (http: Z/java. 
sun.com/docs/codeconv/html/CodeConvTOC.doc.html). Such identifiers might be 
difficult to read and are easier to mistype. 

In contrast to valid identifiers, Java considers the following identifiers to be 
invalid: 

• etally. An identifier cannot start with a digit. 

• my* name. An identifier cannot contain an asterisk. 

• first name. An identifier cannot contain a space. 

• \u0beb\u20ac. Any language's digits can't start an identifier. 

Figure 2.4 illustrates the invalid identifier specified by \u0beb\u20ac. 
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Figure 2.4: Java considers an identifier beginning with a Tamil digit to be 
just as invalid as if that identifier began with an English digit. 

Because Java is a case-sensitive language, identifiers that differ only in the 
case of their letters are treated as distinct. For example, Java treats count 
and Count as distinct identifiers because o and C are different characters. 

Reserved Words and Keywords 

Some identifiers are reserved by the Java language to name types, literals, 
statements, and other language features. Because they are reserved, each 
of those identifiers is known as a reserved word. For example, double is a 
reserved word that specifies the double-precision floating-point type (dis- 
cussed later in this chapter) at the source code level, whereas while is a 
reserved word that introduces the While loop statement (discussed in 
Chapter 4) in source code. You cannot use reserved words to name vari- 
ables, classes, methods, interfaces, packages, or labels. 

With three exceptions, each of Java's reserved words is known as a 
keyword. The exceptions are true, false, and null. Those reserved words are 
not known as keywords because they represent literals — a language feature 
that will be discussed in the next chapter. 

✓ To view a complete table of Java's 52 reserved words, see "Reserved Words," p. 783. 

Java's case sensitivity leads to an interesting possibility when dealing with 
reserved words: Even though you cannot use a keyword like continue to 
name variables (and so on), you can choose an identifier called Continue and 
use that identifier in your source code. However, that practice might con- 
fuse someone who is studying your code. Therefore, avoid choosing identi- 
fiers that resemble keywords or the literals true, false, and null. 



Types 



Java is a strongly typed language. That helps the compiler detect errors 
during compilation. Each variable and expression (discussed in the next 
chapter) has a type known to the compiler. A type is a specification for a set 
of values and a set of operations that can be legally applied to those values 
to produce new values. Types limit what values can be held by variables or 
produced by expressions, limit what operations can be performed on those 
values, and determine the meaning of such operations. Java divides its 
types into primitive and reference categories. 



04 71710_CH02 11/21/01 12:00 PM Page 60 




60 Chapter 2: From Unicode to Types 



Primitive Types 

A primitive type is a JVM-defined Boolean or numeric type. The numeric 
types include byte, character, double-precision floating-point, floating-point, 
integer, long integer, and short integer. 

Java's Boolean tj^e describes the representation of Boolean (true/false) val- 
ues. Those values are often generated by Boolean expressions that compare 
values. For example, x > y is a Boolean expression that compares the value 
in a variable named x with a value in a variable named y. If x's value is 
greater than (as indicated by >) y's value, x > y returns a Boolean true 
value. Otherwise, x > y returns a Boolean false value. (Expressions and 
variables are discussed in the next chapter). The JVM is flexible in how it 
represents Booleans. For example, it is possible for the JVM to use a 32-bit 
integer to represent a Boolean, with 1 representing true and 0 representing 
false. Only the bitwise/logical, conditional, equality, logical complement, 
and some compound assignment operators (discussed in the next chapter) 
can be legally performed on Boolean values. Use the boolean keyword to 
specify a Boolean type in source code. 



NOTE 

The next chapter discusses the use of a type keyword as part of a variable declaration. 
That chapter also presents examples that show how to introduce Boolean and other 
type keywords (such as int) in source code. 



Java's bj^e type describes the representation of signed 8-bit integers that 
range from -128 to 127 (inclusive). (Signed integers are integers that can 
be either positive or negative.) The JVM uses a special format to represent 
a byte in memory. That format reserves the leftmost bit as the sign bit — an 
indicator of positive or negative (0 for positive and 1 for negative). The 
seven bits to the right of the sign bit identify the byte's magnitude (its 
value), as follows: If the sign bit is 0, the remaining bits direct convert from 
binary to decimal to reveal the magnitude. However, if the sign bit is 1, the 
remaining bits indirectly convert from binary to decimal to reveal the mag- 
nitude, through a process known as twos-complement. To achieve twos- 
complement, flip each bit's value (in the byte) from one state to another 
state (such as 1 to 0 or 0 to 1), to produce a new number, and add 1 to the 
new number. Figure 2.5 illustrates positive and negative bytes in memory: 
35 hexadecimal (53 decimal) and FE hexadecimal (-2 decimal). 

The compiler generates bytecode instructions to convert a byte to an integer 
(or long integer) before performing an operation (such as addition). After 
the operation completes, the integer/long integer is converted back to a byte 
by other bytecode instructions. Use the byte keyword to introduce the byte 
type in source code. 
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Figure 2.5: The internal binary representation of positive and negative 
bytes each shows a sign bit followed by seven bits that specify the byte's 
magnitude. 

Java's character type describes the representation of unsigned 16-bit inte- 
gers (that is, integers that are not regarded as being positive or negative) 
that range from 0 to 65535 (inclusive) and hold the Unicode numbers asso- 
ciated with character symbols. Various operations (such as arithmetic oper- 
ations) can be applied to characters, but the compiler must generate special 
bytecode instructions to convert a character to an integer (or long integer) 
before those operations can be performed. (The compiler also generates 
bytecode instructions to convert the integer/long integer back to a character 
after the operation completes.) Use the char keyword to represent a charac- 
ter type in source code. 

Java's double-precision floating-point type describes the representation of 
signed double-precision floating-point numbers in memory. Those numbers 
range from approximately ±2.23+10"'^^^ to ±1.79-1-10'^^^ and conform to 
the IEEE 754 specification. The JVM conforms to that specification by 
assigning 64 bits to hold the number, by reserving the leftmost bit as the 
number's sign bit (0 for positive and 1 for negative), by reserving the next 
eleven bits to hold the exponent (the range of numbers that can be repre- 
sented), and by reserving the final 52 bits to hold the number's mantissa 
(the significant digits that determine accuracy). Use the double keyword to 
represent a double-precision floating-point type in source code. 

Java's floating-point type describes the representation of signed floating- 
point numbers in memory. Those numbers range from approximately 
±1.18+10-38 to ±3.40+1038 and conform to the IEEE 754 specification. The 
JVM conforms to that specification by assigning 32 bits to hold the number, 
by reserving the leftmost bit as the number's sign bit (0 for positive and 1 
for negative), by reserving the next 8 bits to hold the exponent, and by 
reserving the final 23 bits to hold the number's mantissa. Use the float 
kejrword to represent a floating-point type in source code. 
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NOTE 

To learn more about the IEEE 754 specification, consult the document IEEE Standard 
for Binary Floating-Point Arithmetic (IEEE, 1985). 

Java's integer type describes the representation of signed 32-bit integers 
that range from -2,147,483,648 to 2,147,483,647 (inclusive). The JVM uses 
a special format (similar to the byte format) to represent an integer in 
memory. That format reserves the leftmost bit as the sign bit and specifies 
31 bits to the right of the sign bit to identify the integer's magnitude. Use 
the int keyword to represent an integer type in source code. 

Java's long integer type describes the representation of signed 64-bit 
integers that range from -9,223,372,036,854,775,808 to 
9,223,372,036,854,775,807 (inclusive). The JVM uses a special format (simi- 
lar to the byte format) to represent a long integer in memory. That format 
reserves the leftmost bit as the sign bit and specifies 63 bits to the right of 
the sign bit to identify the long integer's magnitude. Use the long kejrword 
to represent a long integer type in source code. 

Finally, Java's short integer type describes the representation of signed 16- 
bit integers that range from -32,768 to 32,767 (inclusive). The JVM uses a 
special format (similar to the byte format) to represent a short integer in 
memory. That format reserves the leftmost bit as the sign bit and specifies 
15 bits to the right of the sign bit to identify the short integer's magnitude. 
Use the short keyword to represent a short integer type in source code. 

As with bytes, the compiler generates bytecode instructions to convert a 
short integer to either an integer or a long integer before performing an 
arithmetic (or some other) operation. Also, other bytecode instructions are 
generated to convert the integer/long integer back to a short integer when 
the operation finishes. 

Primitive Type Conversion 

Frequently, a value must be converted from one primitive type to another. 
If a narrower value (that is, a value represented with fewer bits) is to be 
converted to a wider value (that is, a value represented with more bits), the 
compiler uses a widening conversion rule to implicitly perform the conver- 
sion. The same is true when converting from a byte, character, integer, long 
integer, or short integer to either a double-precision floating-point or floating- 
point value. 

Widening conversion rules handle exchanges between primitive types with- 
out requiring a cast operator because converting from fewer bits to more 
bits does not result in data loss. Java has 19 widening conversion rules: 
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• Byte to short integer, integer, long integer, floating-point, or double- 
precision floating-point 

• Short integer to integer, long integer, floating-point, or double- 
precision floating-point 

• Character to integer, long integer, floating-point, or double-precision 
floating-point 

• Integer to long integer, floating-point, or double-precision floating- 
point 

• Long integer to floating-point or double-precision floating-point 

• Floating-point to double-precision floating-point 

When converting fi"om fewer bits to more bits for bytes, integers, long inte- 
gers, and short integers, Java copies the sign bit's value into the extra bits. 
When converting from fewer bits to more bits for characters, Java copies 
zeroes into the extra bits. 

If a wider value (that is, a value represented with more bits) is to be con- 
verted to a narrower value (that is, a value represented with fewer bits), 
the compiler uses a narrowing conversion rule to implicitly perform the con- 
version. The same is true when converting from a double-precision floating- 
point or floating-point value to a byte, character, integer, long integer, or 
short integer. 

Narrowing rules handle exchanges between primitive types by requiring a 
cast operator because converting from more bits to fewer bits (or a floating- 
point value to an integer value) results in data loss. Java has 23 narrowing 
conversion rules: 

• Bj^e to character 

• Short integer to byte or character 

• Character to byte or short integer 

• Integer to byte, short integer, or character 

• Long integer to byte, short integer, character, or integer 

• Floating-point to byte, short integer, character, integer, or long integer 

• Double-precision floating-point to byte, short integer, character, inte- 
ger, long integer, or floating-point 

Sometimes, a cast operator is not required when converting from more bits 
to fewer bits. That situation arises when a value stored in a greater num- 
ber of bits is to be converted to a value stored in a fewer number of bits. 
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and no data loss occurs as a result of the conversion. For example, integer 
100 can be converted to a byte without data loss because the range of a byte 
is -128 to 127. Similarly, integer 100 can be converted to a short integer 
without data loss because the range of a short integer is -32,768 to 32,767. 

✓ To learn more about cast operators, see "Unary Operators," p. 98. 

Reference Types 

In contrast to primitive types, a reference type is a developer-defined type 
that is either a class type, an interface type, an array type, or null. A class 
type identifies a class from which objects are created. That implies a vari- 
able associated with a class type can contain a reference to an object cre- 
ated from that class. An interface type is similar to a class type, in that 
both types specify what operations must be performed. The difference 
between those two reference type categories, however, is that an interface 
type does not specify an implementation for any operation, whereas a class 
type can specify implementations. An array type identifies an object that 
stores multiple values of the same type. For example, an integer array type 
identifies an object capable of storing multiple integers. Finally, the null 
type is used to initialize a class type, interface type, or array type variable 
so that variable references nothing. 

Although a discussion of class, interface, and array types must be deferred 
until later chapters, there is one class type of which you should be aware 
(because that class type is commonly used) — String. The String type repre- 
sents a sequence of characters that denote a string. Because Java's design- 
ers discovered that strings are commonly used, they created a class named 
String and provided special language features (simplified assignment and 
an additive operator that performs string concatenation) to simplify work- 
ing with objects created from string. 



What's Next? 



This chapter explored some of Java's non-object-oriented language features 
(namely Unicode, comments, identifiers, and types). Because those features 
are not enough to create Java software, no new applications were pre- 
sented. That will change in the next chapter, which continues to explore 
Java's non-object-oriented language features, by looking at features ranging 
from literals to expressions. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 
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NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 



Reviewing It 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. How is it possible for a Unicode escape sequence to contain multiple 
u's (for example, \uu004l)? 

2. When converting from ASCII to Unicode, what does the compiler do 
when it encounters \ \u0042 in source code? 

3. One of Java's narrowing conversion rules is "byte to character." 
Because a byte occupies 8 bits and a character occupies 16 bits, it 
would appear that no information is lost during a conversion from 
byte to character — so what is the point of that rule? 

4. What are two ways in which Java's designers have simplified working 
with the String class? 

5. How does an interface type differ from a class type? 

6. When is it appropriate to use a double-precision floating-point type 
and when is it appropriate to use a floating-point type? 

7. Can you think of a reason why Java does not allow multiline com- 
ments to nest? 



Checl^ing It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 
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1. Which of the following reserved words is not a keyword? 

a. goto 

b. true 

c. while 

d. None of the above 

2. Which of the following is not a narrowing rule? 

a. Character to integer 

b. Byte to character 

c. Floating-point to byte 

d. a and b 

3. Which of the following reference type categories can be found in struc- 
tured programming languages? 



a. Null 

b. Class 

-Q- c. Interface 



d. Array 

4. What kind of comment is helpful during testing and debugging? 

a. Multiline 

b. Single-line 

c. Documentation 

d. All of the above 

5. What does an identifier name? 

a. Comments 

b. Variables 

c. b and d 

d. Classes 

6. An identifier begins with what? 

a. b and c 

b. A letter 
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c. A digit 

d. All of the above 

7. Identifier names should be what? 

a. Long 

b. Short 

c. Meaningful 

d. All of the above 

8. while is an example of what? 

a. A keyword 

b. A type 

c. A reserved word 

d. a and c 

9. A character is what? 

a. A symbol 

b. An integer number 

c. A mapping from a symbol to an integer number 

d. All of the above 

10. Which numeric type can be used to represent 6 billion? 

a. Short integer 

b. c and d 

c. Floating-point 

d. Long integer 

True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. Multiline comments can be nested. 
True/False 

2. An identifier can start with a digit. 
True/False 
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3. The identifier $total is valid. 
True/False 

4. false is one of Java's keywords. 
True/False 

5. Java is a strongly typed language. 
True/False 

6. Widening conversion rules achieve their objective by using cast 
operators. 

True/False 

7. Java's b3^e type describes the representation of signed 8-bit integers. 
True/False 

8. Java is a case-sensitive language. 
True/False 

9. The null type is a primitive type. 
True/False 

10. ASCII is a subset of Unicode. 
True/False 



Applying It 



APPLY 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. Visit the Unicode Web site and identify the name given to the Unicode 
characters ranging from \u30A0 through \u30FF. 

2. Create five valid identifiers and five invalid identifiers. Make sure 
those identifiers are original: Don't repeat the sample identifiers that 
are specified in this chapter. 

3. Identify primitive types that appear in Chapter I's Craps, java 
application source code. 
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From Literals to Expressions 

The previous chapter started a tour of Java's non-object-oriented language 
features. Specifically, it focused on Unicode, comments, identifiers, and 
types. Although those features are fundamental to all Java source code, 
they aren't enough to write a complete Java application. Before an applica- 
tion can be presented, a few more features are required. Specifically, you 
need to know about literals, variables, operators and separators, and 
expressions. This chapter introduces those new features along with applica- 
tion source code that demonstrates a few of the features covered in this and 
the previous chapter. 
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Literals 




EXAMPLE 




EXAMPLE 



A value (such as an integer) can be literally specified in source code as a 
character sequence that conforms to specific syntax based on the value's 
type. The result is known as a literal. Java classifies literals as Booleans, 
characters, floating-point numbers, integers, nulls, and strings. 

Boolean Literals 

A Boolean literal is specified as either true or false. The type of that literal 
is Boolean. 

The following code fragment (which was excerpted from Chapter I's Craps 
application) demonstrates a Boolean literal: 
boolean firstRoll = true; 

Character Literals 

A character literal is specified as a single printable character (other than 
the single quote and backslash characters) surrounded by a pair of single 
quote characters. The type of that literal is character. 

The following character literals represent printable characters: 

' A ' Capital letter A 

' 0 ' Digit 0 

Double quote " 

Punctuation ; 

Space 

Suppose you want to specify a single quote, a backslash, or a nonprintable 
character (such as a horizontal tab) as a character literal. How would you 
accomplish that task? The answer is to use an escape sequence. An escape 
sequence represents a character by using special syntax. That syntax begins 
with a single backslash character. (The type of a character literal composed 
of an escape sequence is character, as well.) 

If you recall. Chapter 2 mentioned one kind of escape sequence: Unicode. 
Furthermore, the Unicode escape sequence's syntax was shown to consist of 
\uxxxx (where each x represents a hexadecimal digit). By placing that syn- 
tax between a pair of single quote characters, most characters can be repre- 
sented by using character literals. 
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The following character literals use Unicode escape sequences to represent 
printable and nonprintable characters: 



EXAMPLE 



\U0041 ' 


Capital letter A 


\u0030' 


Digit 0 


\U0022' 


Double quote " 


\u003b' 


Punctuation ; 


\U0020' 


Space 


\U0009' 


Horizontal Tab 



Not all characters can be represented by using character literals composed 
of Unicode escape sequences. For example, the Java compiler generates 
errors if you try to specify any of the following: 

' \u0027 ' (a character literal representing a single 

quote) 

' \u005c ' (a character literal representing a backslash) 

' \u000d ' (a character literal representing a carriage 

return) 

' \u000a ' (a character literal representing a newline — 

also known as line feed) 

Because a Unicode escape sequence cannot be used, you must consider 
using a special character escape sequence to represent a single quote, back- 
slash, carriage return, or newline. 

Java provides the special character escape sequence category for represent- 
ing the backslash, double quote, and single quote printable characters, as 
well as the backspace, form feed, newline, carriage return, and horizontal 
tab characters. Table 3.1 summarizes those escape sequences. 

Table 3.1: Special Character Escape Sequences 

Escape Sequence Description 

\\ Backslash 

\ " Double quote 

\ ' Single quote 

\b Backspace 

\f Form feed 

\n Newline 

\r Carriage return 

\t Horizontal tab 
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EXAMPLE 




EXAMPLE 



To create a character literal that represents a character denoted by a spe- 
cial character escape sequence, place the special character escape sequence 
between a pair of single quotes. For example, the ' \ ' ' character literal rep- 
resents a single quote, and the ' \ n' character literal represents a new-line. 

In addition to the Unicode and special character escape sequence cate- 
gories, Java provides octal escape sequences for representing any Unicode 
character whose value ranges from 0 to 255 (inclusive). An octal escape 
sequence consists of three digit characters (where the leftmost digit charac- 
ter ranges from 0 to 3 and the remaining digit characters each range from 0 
to 7) that follow a single backslash character. 

The following character literals use octal escape sequences to represent 
printable and nonprintable characters: 

'\101' Capital letter A 

'\060' Digit 0 

' \ 0 1 5 ' Carriage return 

This section's character literal examples have been biased toward the 
English language. However, international characters can also be repre- 
sented by character literals. 

The following character literals represent two international characters: 
' \ U3063 ' Hiragana letter 

'\u20ac' Euro 

The example demonstrates how to specify character literals that represent 
international characters by using an ASCII-based text editor. Figure 3.1 
illustrates equivalent character literals that are specified by using a 
Unicode-based text editor. 



'O' 
'€' 

Figure 3.1: Character literals representing a Hiragana letter and the euro 
are displayed in a Unicode-based text editor. 



Floating-Point Literals 

A floating-point literal is specified as an integer part, a decimal point (rep- 
resented by the period character), a fractional part, an exponent (repre- 
sented by E or e), and a data type suffix (represented by D, d, F, or f ). At 
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EXAMPLE 




EXAMPLE 



least one digit in either the integer or fractional part, and either a decimal 
point, an exponent, or a type suffix are required. All other parts are 
optional. The type of a floating-point literal defaults to double-precision 
floating-point. (That is also the case if a D or d type suffix is specified.) 
However, if an F or f type suffix is present, the type is floating-point. 

The following floating-point literals represent double-precision floating- 
point and floating-point values. 

6 . 5E+32 (or 6 . 5E32) Double-precision floating-point literal 

7D Double-precision floating-point literal 

. 0 1 f Floating-point literal 

Integer Literals 

An integer literal is specified as a sequence of digits and an optional type 
suffix (represented by L or l). At least one digit must be specified. The type 
of an integer literal defaults to integer. However, if an L or l type suffix is 
specified, the type is long integer. 

TIP 

To specify a long integer literal, it is best to use the L suffix instead of 1. The reason is 
that the lowercase letter 1 and digit 1 are similar in appearance — a potential source of 
confusion. 

Integers can be specified in either the decimal, hexadecimal, or octal for- 
mat. Decimal format is indicated by a leftmost nonzero digit. Hexadecimal 
format is indicated by the characters 0x or 0X appearing to the left of at 
least one hexadecimal digit — a digit 0 through 9, an uppercase letter A 
through F, or a lowercase letter a through f . Finally, octal format is indi- 
cated by a zero digit followed by digits that range from 0 through 7. 

The following integer literals represent integer values expressed in decimal, 
hexadecimal, and octal format. 

65 9 L Decimal integer literal of type long integer 

0x4a Hexadecimal integer literal of type integer 

057 L Octal integer literal of type long integer 

Null Literals 

A null literal is specified in source code as null. That literal is often used to 
reduce the number of references to an object, and its type is always null. 
You typically assign null literals to object reference variables. 
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EXAMPLE 




EXAMPLE 



The following code fragment assumes the existence of an object referenced 
by e. By assigning null to e, you reduce the number of references to an 
object. When an object is no longer referenced, that object becomes eligible 
for garbage collection. (Don't worry about objects and garbage collection. 
Those concepts are discussed in Chapters 5 and 8, respectively.) 
e = null; 

String Literals 

A string literal consists of zero or more characters surrounded by double 
quote " characters. Those characters can consist of all printable characters 
(except for the double quote and backslash) and nonprintable characters. 
The double quote, backslash, and nonprintable characters are represented 
by escape sequences. The type of a string literal is String. 

The following string literals represent sequences of characters: 

"This is a \"string\" literal." 

"This string literal ends with a new-line escape sequence. \n" 
"This string literal contains a euro \u20ac character." 
" " (The empty string — no characters) 

NOTE 

When the compiler encounters a string literal, it generates bytecodes that create an 
object of type String and store the literal's characters in that object. That situation will 
be examined in Chapter 12. 



Variables 



A Java program manipulates values, represented in source code by literals. 
Those values are typically stored in memory locations, with each memory 
location represented by a name and a type at the source code level. The 
combination of name and type is known as a variable. 

Java classifies a variable in three ways. First, that variable is either a 
primitive variable (based on a primitive type) or a reference variable (based 
on a reference type). Second, that variable is either a simple variable (capa- 
ble of storing a single value) or an array variable (capable of storing multi- 
ple values). Finally, that variable is either a class variable, an instance 
variable, an array component variable, a method parameter variable, a con- 
structor parameter variable, an exception handler parameter variable, or a 
local variable. 
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With so much to learn, it's easy to feel overwhelmed. Therefore, to make 
variables easier to understand, this section examines only a few concepts — 
the declaration and initialization of primitive and reference array and non- 
array variables, to be exact. Later chapters cover the remaining concepts. 

Declaration 

Variables must be declared before they can be used. A variable declaration 
introduces a variable to the compiler as a name and a type. The way the 
variable is declared depends on whether it is a simple variable or an array 
variable. 

Simple Variable Declaration 

A simple variable is declared by using the following syntax: 
typeldentifier variableldentifier ' ; ' 

According to the syntax, typeldentifier specifies the variable's type using 
either a primitive type keyword — boolean, byte, char, double, float, int, 
long, or short — or a reference type identifier (such as String). The name of 
the variable is specified by variableldentifier and must not be a reserved 
word. 



The following declarations introduce a few simple variables of primitive 
and reference types: 



CAUTION 

Reserved words cannot be used as variable names. For example, the compiler flags 
int while; as an error because while is a reserved word. 

Multiple simple variables can be specified in a single variable declaration 
by separating the variable names with commas. 

The following declaration introduces a few simple variables of primitive 

type integer: 

int count, total, age; 



string lastName; 



double amountOwing; 



int \u3063; 



\u3063 (Hiragana letter) stores an integer. 

amountOwing stores a double-precision 
floating-point number. 

lastName stores a reference to a String object. 



Array Variable Declaration 

An array variable is declared by using the following syntax: 

typeldentifier ' [' ' ]' variableldentifier ' ; ' 
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The array variable declaration syntax is similar to the previous simple 
variable declaration syntax. As with simple variable declarations, 
variableldentifier names the array variable and must not be a reserved 
word. However, typeidentifier is a little different in the context of arrays. 

Before continuing, ask yourself the following question: What is an array? 
The answer is: a block of memory divided into separate storage locations. 
Each storage location is capable of holding a single value of a specific type. 
However, the types of all values in all of those storage locations must be the 
same. And what is that type? The answer is: typeidentifier. 

Java regards an array as an object, variableldentifier contains a reference 
to a block of memory. Each of the storage locations in that block is known 
as an array component variable or element and is identified by an index, 
typeidentifier is the type of each element and is represented in source code 
either by a primitive type keyword — boolean, byte, char, double, float, int, 
long, or short — or by a reference type identifier (such as String). In con- 
trast, typeidentifier [ ] represents the type of variableldentifier (and is a 
reference type). 

The following declarations introduce a few array variables whose elements 
are of primitive and reference types: 

char [] gradeLetters; gradeLetters references an array of 
EXAMPLE characters. 

float [] temps; temps references an array of floating- 

point numbers. 

String [] countryNames; countryNames references an array of 

references to String objects. 

The example declares three array variables. The gradeLetters array is of 
type character [] (as represented by char [ ]), and the type of each element 
is character. Similarly, the temps array is of type floating-point [] (as repre- 
sented by float [ ]), and the type of each element is floating-point. Finally, 
the countryNames array is of type String [], and the type of each element is 
String. 

Declaration causes memory to be allocated for array variables but not for 
the storage locations comprising each array. After all, there is no indication 
of the size of the array (that is, the number of elements composing the 
array) during declaration. Later, you will learn how to allocate memory for 
array elements. 




As a concession to C/C++, Java allows you to specify the square brackets 
after the variable name (as in int inventoryTotals [];). However, to 
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improve source code readability, it is customary to specify the square brack- 
ets after typeldentifier. 

CAUTION 

Unlike in C++, you must not specify the size of tine array by placing either an integer lit- 
eral or an integer variable, initialized to some value, between the square brackets. For 
example, do not specify char [10] gradeLetters; to declare a gradeLetters array 
capable of storing 10 characters. Also, do not specify int inventoryTotals [i] ; — 
where i is an integer variable initialized to some value. Either declaration results in a 
compiler error message. 



Multiple array variables can be specified in a single variable declaration by 
separating the variable names with commas. 

The following declaration introduces a few array variables whose elements 

are of type String: 

String [] names, addresses, cities; 

Initialization 

During declaration, a variable can be initialized to a value. The way the 
variable is initialized depends on whether it is a simple variable or an 
array variable. 

Simple Variable Initialization 

A simple variable can be initialized when it is declared by using the follow- 
ing syntax: 

typeldentifier variableldentifier [ '=' expression ] ';' 

To initialize a simple variable as part of its declaration, specify assignment 
operator = followed by an expression whose type matches typeldentifier. 

The following declarations introduce a few initialized simple variables of 

primitive and reference types: 

int age = 65; 

double balance = 30000.0; 

String name = "Sun Microsystems"; 

In the example, both age and 65 are of type integer. Therefore, the initial- 
ization of age to 65 is legal. The other declarations are also legal because 
the variable and expression types match. 

The following declarations are illegal because the types of the variable and 
expression (in each declaration) do not match: 

short s = 50000; 
int i = "abc" ; 
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In the first declaration, an attempt is made to assign an integer literal to a 
short integer variable, which is unacceptable — unless a cast operator is 
used to implement a narrowing conversion rule. (A corrected version of the 
first declaration is shown where cast operators are discussed in the Unary 
Operators section of this chapter.) In the second declaration, an attempt to 
assign a string literal (of type String) to an integer variable is meaningless, 
and there is no cast operator to make a correction. 

CAUTION 

Attempting to initialize a variable with a literal of a different type is a common source of 
error. However, Java allows some flexibility in that area: Java supports the assignment 
of certain integer literals to byte and short integer variables. 




EXAMPLE 




EXAMPLE 



The compiler allows only one situation where literals of one type can be 
assigned to variables of another type: An integer literal can be assigned to 
either a byte variable, a short integer variable, or a character variable pro- 
vided that the value of the literal fits within the variable's acceptable range 
of values. 

The following declarations with initialization prove that it is possible to 
assign integer literals to byte, short integer, or character variables, 
byte b = 100; 
short s = 1000; 
char c = 60000; 

The first declaration is legal because 1 00 fits within a byte's range of values: 
-128 to 127 (inclusive). Similarly, the second declaration is legal because 
1000 fits within a short integer's -32768 to 32767 (inclusive) range of values. 
Finally, the third declaration is legal because 60000 fits within a character's 
range of values: 0 to 65535 (inclusive). 

After a simple variable has been initialized, its value can be accessed by 
specifying the variable's name in source code. 

The following code fragment declares and initializes a variable named bi . 
Then, a variable named b2 is declared and initialized to the value contained 
in b2. 



byte b1 
byte b2 



10li 
b1 ; 



Multiple simple variables can be initialized in a single variable declaration 
by using commas. 
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The following declaration introduces a few simple variables of primitive 
type integer and initializes two of those variables: 
int count = 0, total, age = 25; 

To put simple variable declaration and initialization concepts into perspec- 
tive, Figure 3.2 illustrates the parts of a simple variable declaration and 
initialization, and the resulting memory representation. 



keyword byte (simple variable's type) 



integer literal 103 (sample variable's value) 



byte b = 103; 



- symbol = (assignment operator) 



identifier b (simple variable's name' 

b 



0 


1 


1 


0 


0 


1 


1 


1 



Figure 3.2: A simple variable is declared and initialized, and the result is 
stored in memory. 




EXAMPLE 



Array Variable Initialization 

An array variable can be initialized when it is declared by using the follow- 
ing syntax: 

typeldentifier ' [' ' ]' variableldentifier 

[ ' = ' '{' expression ',' ... ',' expression '}' ] ';' 

To initialize an array variable when it is declared, specify the assignment 
operator = followed by a comma-delimited sequence of expressions that are 
placed between brace characters { and }. Each expression's type must 
match the type represented in source code by typeldentifier. 

The following declarations introduce a few initialized array variables of 

primitive and reference types: 

char [] yesNo = { 'Y', 'y', 'N', 'n' }; 

float [] percents = { 0.25f, 0.5f, 0.75f }; 

String [] titles = { "Dr.", "Mr.", "Mrs.", "Ms.", "Rev." }; 

yesNo is an array of four character elements; percents is an array of three 
floating-point elements; and titles is an array of five String reference ele- 
ments. Notice the lowercase letter f appearing to the right of 0.25, 0.5, and 
0 . 75. That letter specifies each literal's type as floating-point. 
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After an array variable has been initialized, its values can be accessed by 
specifying the following syntax: 
variableldentifier '[' expression ']' 

The syntax shows how to access an array element, expression is an integer 
expression that indexes (that is, accesses) a specific array element. (A 0 
value accesses element 0, a 1 value accesses element 1, and so on.) Like 
C++, Java's array elements begin at index zero. 

The following code fragment declares and initializes an array variable 
called innerPlanetNames and accesses the second element (at index one — 
Venus), which subsequently prints: 

EXAMPLE String [] innerPlanetNames = { 'Mercury', 'Venus', 'Earth', 'Mars' }; 
System. out. println (innerPlanetNames [1]); 

Java provides a convenient mechanism for determining the number of ele- 
ments in an array — the length property. To return the length of an array, 
simply attach a period character followed by length to the array variable's 
name. 

The following code fragment returns the length of the previous example's 
innerPlanetNames array (which is four) and subsequently prints that value: 
System. out. println (innerPlanetNames . length) ; 

Multiple array variables can be initialized in a single variable declaration. 
That is accomplished by using commas to separate variable names from ini- 
tializations. 

The following declaration introduces a few array variables whose elements 
are of primitive type integer and initializes two of those variables: 
int [] num1 ={1,2}, num2, num3 = { 3, 4, 5 }; 

To put the array variable declaration and initialization concepts into per- 
spective. Figure 3.3 illustrates the parts of an array variable declaration 
and initialization, and the resulting memory representation. 




EXAMPLE 




EXAMPLE 
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keyword byte (element type) 



byte[] 

(array variable's type) 



byte []b = { 103, 104 }; 



integer literals 103 and 104 (element 



symbol = (assignment operator) 



b: [ 



identifier b (array variable's name) 

■ index 0 (accesses element 0) 

element 0 



r 

[01: 

m- 



oh 


1 


0 


0 


1 


1 


1 




oh 


1 


0 


1 


0 


0 


0 



element 1 



index 1 (accesses element 1) 



Figure 3.3: An array variable is declared and initialized, and the result is 
stored in memory. 



Separators and Operators 



One of a compiler's first tasks is to parse input characters into basic lan- 
guage elements. Each element is known as a token. Examples of tokens 
include Unicode escape sequences, identifiers, and the various characters 
composing literals, separators, and operators. 

Separators 

A separator is one or two tokens that separate some language features from 
other language features. Separators include the following: 

• Parentheses ( and ) for specifying a precedence change in an expres- 
sion (by separating that part of an expression which is to be given 
higher precedence from the rest of the expression) or a cast operator 
(by separating a typeldentifier from the rest of an expression) 

• Braces { and } for grouping zero or more statements into a block of 
statements and separating those statements from statements appear- 
ing outside the block 
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• Square brackets [ and ] for declaring an array or accessing an array 
element's value (by separating an array index from the rest of an 
array access expression) 

• Semicolon ( ; ) for separating one statement from another 

• Comma ( , ) for separating variable names and optional initializations 
in a variable declaration 

• Period ( . ) for separating fields and methods in a field or method 
access expression 

Not all of the preceding concepts will make sense to you right now, but 
don't worry. As you keep reading through this and future chapters, you'll 
find that those concepts aren't incomprehensible. 

CAUTION 

When specifying the parentheses, braces, or square brackets separators, you must 
specify both opening and closing characters that make up the separator. Otherwise, you 
will receive one or more compiler error messages. 



Operators 

An operator is a language feature, represented by a token, that transforms 
one or more values (of a certain type) into a new value. Each value being 
operated on is known as an operand. A classic example of an operator is the 
additive operator that performs addition (+). That operator adds its two 
numeric operands together and yields a new numeric value — the sum. 

The Java Language Specification (JLS) identifies all operators supported 
by Java. It states that "37 tokens are the operators." Table 3.2 lists those 
operator tokens. 

Table 3.2: Operator Tokens 

= > < ! - 

? : == <= >= 

!= && II ++ 

+ - * / & 

I - % « » 

>» += -= *= / = 

&= 1= '= %= «= 

»= »>= 

In addition to Table 3.2's list of operator tokens, the JLS refers to the 
instanceof token as an operator and also refers to the cast operator — a 
combination of a parentheses separator and a typeldentifier. 
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Classifving Operators: Unary, Binary, and Ternary 

An operator can be classified by the number of required operands. 
Resulting classifications include unary, binary, and ternary. A unary opera- 
tor takes one operand. Negation is an example. If an operator takes a pair 
of operands, that operator is known as a binary operator. The previously 
mentioned additive operators that perform addition and subtraction are 
examples of binary operators. Finally, a ternary operator takes three 
operands. The conditional operator is Java's only ternary operator. 

A potential problem arises when dealing with binary and ternary operators. 
Suppose the types of a binary/ternary operator's operands do not match. 
What does the compiler do? In many cases, the compiler uses a widening 
conversion rule (see Chapter 2) to make sure that the types of a binary or 
ternary operator's operands are the same. For example, if the type of one of 
the operands to an additive operator is integer and the other operand's type 
is short integer, the compiler will generate bytecode instructions that con- 
vert the short integer to an integer prior to generating bytecode instruc- 
tions that perform the additive operation. However, if operand types are 
very different (such as one operand having the Boolean type and another 
operand having the character type), the compiler will display one or more 
error messages. 

Classifying Operators: Prefix, Postfix, and Infix 

Operators can also be classified as prefix, postfix, or infix. A prefix operator 
precedes its operand, whereas a postfix operator trails its operand. The bit- 
wise complement operator is an example of a prefix operator, and the 
postincrement operator is an example of a postfix operator. All unary 
operators are either prefix or postfix operators. 

If an operator is situated between its operands, that operator is known as 
an infix operator. The additive operators are examples of infix operators 
because their tokens appear between pairs of operands. All binary and 
ternary operators are infix operators. 

Additive Operators 

The additive operators perform addition, string concatenation, and subtrac- 
tion. Those operators are represented in source code by the + and - tokens. 

The additive operator (+) is one example of Java's overloaded operators. 
When applied to numeric operands, + performs addition by adding those 
operands together. However, + also performs string concatenation when 
applied to at least one String operand. In either case, that operator has the 
following syntax: 
operandi ' + ' operand2 
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EXAMPLE 




When + is used for addition, each operand type must be one of byte, charac- 
ter, double-precision floating-point, floating-point, integer, long integer, or 
short integer. If the operand types don't match, the compiler will use a 
widening rule to convert the operand whose type represents a more 
restricted range of values to the type of the other operand. When + is used 
for string concatenation, either or both operand types must be String. If 
only one type is String, it is legal for the other type to be any valid type. 

The following code fragment demonstrates the additive operator for addi- 
tion and string concatenation: 

int count = 10; 
count = count + 1 ; 

System. out. println ("count = " + count); 

count + 1 adds 1 to the value stored in count, "count = " + count converts 
the value stored in count to a String object (behind the scenes) and concate- 
nates the resulting object's characters to the "count = " string literal. The 
result is: count = 11. 

The additive operator ( - ) performs subtraction by subtracting the right 
operand from the left operand. That operator has the following syntax: 

operandi ' - ' operand2 

Each operand type must be one of byte, character, double-precision floating- 
point, floating-point, integer, long integer, or short integer. If the operand 
types don't match, the compiler will use a widening rule to convert the 
operand whose type represents a more restricted range of values to the type 
of the other operand. 

The following code fragment demonstrates the additive operator for 
subtraction: 

int i = 1; / / i is initialized to 1 



EXAMPLE int i = i - 1 ; // i is initialized to the value of i 

i - 1 subtracts 1 from the value stored in i. 



Assignment Operators 

The assignment operators either simply assign the result of an expression 
to a variable or perform an operation in conjunction with assignment. 
Those operators are represented in source code by the =, +=, *=, /=, &=, |=, 
%=, «=, »=, and »>= tokens. 

The simple assignment operator (=) evaluates its right operand and assigns 
the result to its left operand (which must be a variable). That operator has 
the following syntax: 



operandi operand2 
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The types of both operands must agree. Otherwise, the compiler will either 
use a widening conversion rule or report an error. 

The following code fragment demonstrates the simple assignment operator: 
String name = "Java Jeff"; 

Each compound assignment operator evaluates its left operand (which must 
be a variable), evaluates its right operand, performs the operation on both 
values, and stores the result in its left operand. Those operators adhere to 
the following syntax: 

operandi ( '+=' | '-=' | '*=' | '/=' | '&=' | ' \=' \ | '%=' | 

'«=' I '»=' I '»>=') operand2 

As with simple assignment, the types of both operands must agree. 
Otherwise, the compiler will either use a widening conversion rule or report 
an error. 

The following code fragment demonstrates the compound assignment oper- 
ator that performs addition/string concatenation in addition to assignment: 
double amount = 30000.0; 

amount += 60000; // equivalent to amount = amount + 60000; 

System. out. println (amount); // Print: 90000.0 

In the example, amount is of type double-precision floating-point and 60000 is 
of type integer. Before the += operation is performed, 60000 is converted 
from integer to double-precision floating-point. 

Bitwise and Logical Operators 

The bitwise and logical operators perform bitwise/logical AND, bitwise/ 
logical exclusive OR, and bitwise/logical inclusive OR operations at either 
the binary digit (bit) or Boolean levels. Those three operators are a second 
example of Java's overloaded operators and are represented in source code 
by the &, and | tokens. 

For each operator, their operand types must be one of Boolean, byte, char- 
acter, integer, long integer, or short integer. If the operand types don't 
match, the compiler will either use a widening rule to convert the operand 
whose type represents a more restricted range of values to the type of the 
other operand, or display an error message if the types are radically differ- 
ent (such as using Boolean with integer). 

The bitwise/logical AND operator (&) works as follows: From a numeric per- 
spective, if corresponding bits in both numeric operands are 1, the result is 
1. Otherwise, the result is 0. However, from a Boolean perspective, if both 
Boolean operands evaluate to true, the result is true. Otherwise, the result 
is false. That operator has the following syntax: 
operandi '&' operandi 
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The following code fragment demonstrates the bitwise/logical AND 
operator: 

byte b = 0x14; // b contains 20 (decimal), 

b &= 7; // b now contains 6. 

boolean first = true; // first contains true 
first &= false; // first now contains false; 

The bitwise/logical exclusive OR operator (") works as follows: From a 
numeric perspective, if corresponding bits in both numeric operands are 1 
or 0, the result is 0. Otherwise, the result is 1. However, from a Boolean 
perspective, if both Boolean operands are true or false, the result is false. 
Otherwise, the result is true. That operator has the following syntax: 
operandi ' " ' operand2 

The following code fragment demonstrates the bitwise/logical exclusive OR 
operator: 

byte b1 = 0x14; // b1 contains 20 (decimal), 

byte b2 = 8; // b2 contains 8 

b1 "= b2; // b1 contains 6 

b2 = (byte) (b1 " b2); // b2 contains 20 
b1 "= b2; // b1 contains 8 



boolean first = true; // first contains true 
boolean second = true; // second contains true 
first = first " second; // first contains false 

The example demonstrates using the bitwise/logical exclusive OR operator 
to exchange (also known as swap) values without the need for a temporary 
variable. That "bitwise exclusive OR exchange" is just one of three tech- 
niques for exchanging variable contents. To see all of those techniques, 
check out Listing 3.1's source code to the Exchange application. 

Listing 3.1: Exchange, java. 
// Exchange. java 



class Exchange 
{ 

public static void main (String [] args) 
{ 

int num1 = 10, num2 = 20, temp; 

// Perform a traditional exchange. This requires the use of a 
// temporary variable. Any data types can be exchanged. 



System. out. println ("Traditional Exchange"); 
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Listing 3.1: continued 

temp = nun1 ; 
nun1 = nun2; 
nun2 = temp; 



System. out. println ("nun1 = " + numl ) ; 
System. out. println ("num2 = " + num2); 



// Reset variables to original values. 



num1 = 10; 
num2 = 20; 



// Perform an additive exchange. No temporary variable is 
// needed. Only numeric types can be exchanged. 



System. out. println ("\nAdditive Exchange"); 



num1 += num2; 

num2 = num1 - num2; 

num1 -= num2; 

System. out. println ("num1 = " + numl); 
System. out. println ("num2 = " + num2); 

// Reset variables to original values. 



num1 = 10; 
num2 = 20; 



// Perform a bitwise exclusive OR exchange. No temporary 
// variable is needed. All numeric types except floating- 
// point and double-precision floating-point can be exchanged. 



System. out. println ("\nBitwise exclusive OR Exchange"); 



numl "= num2; 

num2 = numl " num2; 

numl "= num2; 



System. out. println ("numl = " -i- numl); 
System. out. println ("num2 = " + num2); 

} 

} 

Finally, the bitwise/logical inclusive OR operator works as follows: From a 
numeric perspective, if corresponding bits in both numeric operands are 0, 
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the result is 0. Otherwise, the result is 1. However, from a Boolean perspec- 
tive, if both Boolean operands are false, the result is false. Otherwise, the 
result is true. That operator has the following syntax: 

operandi ' | ' operandi 

The following code fragment demonstrates the bitwise/logical inclusive OR 
operator: 

byte b1 = 0x10; // b1 contains 16 (decimal). 

EXAMPLE byte b2 = 4; // b2 contains 4 

b1 1= b2; // b1 contains 20 (decimal). 

boolean first = true; // first contains true 
boolean second = true; // second contains true 
first = first | second; // first contains true 

Conditional Operators 

The conditional operators either evaluate the left operand and conditionally 
evaluate the right operand, or evaluate one of two operands based on a 
third operand. You represent those operators in source code by using the &&, 
I I , and ? : tokens. 

The conditional AND operator (&&) behaves in a manner that is similar to 
bitwise/logical AND. However, with conditional AND, if the left operand 
evaluates to false, the right operand is not evaluated (because the final 
result is guaranteed to be false). That operator has the following syntax: 
operandi '&&' operandi 

Each operand type must be Boolean. 

The following code fragment demonstrates the conditional AND operator: 

int numApplicants = 0; 
int age = 60; 

boolean stopCondition = age > 64 && ++numApplicants < 100; 

The example introduces two operators not yet covered: > (relational greater 
than) and ++ (preincrement), age > 64 returns true if the value stored in age 
is greater than 64. ++numApplicants < 100 first adds one to the value stored 
in numApplicants and then returns true if the new value is less than 100. If 
both age is greater than 64 and the new value stored in numApplicants is 
still less than 100, && returns true — which subsequently assigns to 
StopCondition. 

In the example, age is assigned 60 and age > 64 returns false. Because the 
left operand evaluates to false, && does not evaluate the right operand. As a 
result, numApplicants is not incremented — a side effect of evaluating age > 




EXAMPLE 
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64 && ++numApplicants < 100. That is a problem if numApplicants should 
always be incremented, whether age is greater than 64 or not. In that situa- 
tion, the problem is solved by replacing && with & — which evaluates both 
operands before performing a logical AND. 

So why does conditional AND differ from logical AND by short circuiting 
the evaluation of its right operand? The answer has to do with objects. 

Suppose you have the following code fragment: 

String s = null; 
boolean result = s != null && s. length () > 5; 



EXAMPLE 




EXAMPLE 



The code fragment declares a String variable initialized to null and then 
uses the && operator to evaluate the left operand. Because s != null returns 
false, && does not evaluate the right operand. It is a good thing that && does 
not evaluate s . length ( ) > 5. The reason is that s contains null and an 
attempt to call s . length ( ) — to return the number of characters contained in 
the String object referenced by s (the string's length) — would result in a 
runtime exception, which would terminate the program. But if & 
(bitwise/logical AND) is substituted for &&, that exception occurs as 
bitwise/logical AND and evaluates both operands. 

The conditional OR operator ( | |) behaves in a manner that is similar to 
bitwise/logical OR. However, with conditional OR, if the left operand evalu- 
ates to true, the right operand is not evaluated (because the final result is 
guaranteed to be true). That operator has the following syntax: 

operandi ' | | ' operand2 

Each operand type must be Boolean. 

The following code fragment demonstrates the conditional OR operator: 
int i = 2; 
int i = 2; 

boolean result = i > 1 || (i = 3); 
System. out. println ("j = " + ]); 

Because i is greater than i , j is not assigned the value 3. As a result, j = 2 
is output. However, if you change j to 1 , you will see something different. 

The conditional operator (? : ) uses the Boolean value of one operand to 
determine which of two other operands should be evaluated. That operator 
has the following syntax: 

operandi ' ? ' operand2 ' : ' operands 

operandi (which must be a Boolean operand) is evaluated. If the result is 
true, operand2 is evaluated and its result is returned by the conditional 
operator. Otherwise, operands is evaluated and the conditional operator 
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returns the result. The types of operand2 and operands must agree: The com- 
piler might use a widening conversion rule to ensure that happens. 

The following code fragment demonstrates using the conditional operator to 
convert from Boolean to integer and back: 

boolean b = true; 
EXAMPLE int X = (b == true) ? 1 : 0; 

b = (X != 0) ? true : false; 

Equality Operators 

The equality operators do one of three things: They compare two numeric 
operands to see whether those operands are identical or not; they compare 
two Boolean operands to see whether they are identical or not; or they com- 
pare two reference operands to see whether both operands contain the same 
references or not. The equality operators are represented in source code by 
the == and ! = tokens. 

For each operator, if the operand types don't match, the compiler will either 
use a widening rule to convert the operand whose type represents a more 
restricted range of values to the type of the other operand, or display an 
error message if the types are radically different (such as using Boolean 
with integer). 

The equality operator (==) checks to see whether two operands are equal. It 
returns true if they are equal. Otherwise, false is returned. That operator 
has the following syntax: 
operandi ' == ' operand2 

The following code fragment demonstrates the equality operator: 

String s = "abc" ; 
String t = "abc" ; 
System. out. println (s == t); 

The equality operator ( ! =) checks to see whether two operands are not 
equal. It returns true if they are not equal. Otherwise, false is returned. 
That operator has the following syntax: 
operandi '!=' operand2 

The following code fragment demonstrates the inequality operator: 

String s = "abc" ; 
String t = "abc" ; 
System. out. println (s != t); 




EXAMPLE 




EXAMPLE 
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Multiplicative Operators 

The multiplicative operators perform multiplication, division, and remain- 
der. Those operators are represented in source code by the *, /, and % 
tokens. 

For each operator, the operand types must be one of byte, character, double- 
precision floating-point, floating-point, integer, long integer, or short inte- 
ger. If the operand types don't match, the compiler will use a widening rule 
to convert the operand whose type represents a more restricted range of 
values to the type of the other operand. 

The multiplicative operator (*) performs multiplication. That operator has 
the following syntax: 

operandi ' * ' operand2 

The following code fragment demonstrates the multiplicative operator that 
performs multiplication: 

double PI = 3.14159; 

double diameter = 10.0; 

double circumference = PI * diameter; 

The multiplicative operator (/) performs division. That operator has the fol- 
lowing syntax: 

operandi ' I ' operandi 

The following code fragment demonstrates the multiplicative operator that 
performs division: 

double totalPaid = 20000.0; 

int itemsSold = 5000; 

double unitCost = totalPaid / itemsSold; 

float f = 1 .0f / 0.0f ; 
int i = 1 / 0; 

In the example, the last two lines of code attempt to divide by zero. When 
an attempt is made to perform a floating-point division by zero (such as 
1 .0f / 0.0f), a special value is stored in the variable (such as +lnfinity). 
However, when an attempt is made to perform an integer division by zero 
(such as 1 / 0), an exception is thrown. 

✓ To learn more about special mathematical values (such as +lnflnlty), see "Java and 
Mathematics," p. 580. To learn more about throwing exceptions, see 
"Throwing Exceptions," p. 342. 

In addition to +lnf inity, what other special mathematical values can be 
generated from dividing by zero? Give up? Compile and run Listing 3.2's 
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source code to the DivideByZero application for an answer. That apphcation 
also demonstrates the exception that is thrown when an attempt is made to 
perform an integer division. 

Listing 3.2: DivideByZero. java. 
// DivideByZero. java 

class DivideByZero 
{ 

public static void main (String [] args) 
{ 

System. out. println (1.0 / 0.0); 
System. out. println (-1.0 / 0.0); 
System. out. println (0.0 / 0.0); 
System. out. println (1 / 0); 

} 

} 

To round out the multiplicative operators, the multiplicative operator (%) 
performs integer remainder. That operator has the following syntax: 

operandi '%' operand2 

^ \ I / The following code fragment demonstrates the multiplicative operator that 
svISr performs remainder: 

short num = 57; 
EXAMPLE tens = num / 10; // tens contains 5 

int ones = num % 10; // ones contains 7 



Relational Operators 

The relational operators relate operands to each other either numerically or 
referentially They are represented in source code by the <, <=, >, >=, and 
instanceof tokens. 

For each operator (other than instanceof), the operand types must be one of 
byte, character, double-precision floating-point, floating-point, integer, long 
integer, or short integer. If the operand types don't match, the compiler will 
use a widening rule to convert the operand whose type represents a more 
restricted range of values to the type of the other operand. 

The relational less than operator (<) compares two values and returns a 
Boolean true value if the left operand is numerically less than the right 
operand. Otherwise, it returns false. That operator has the following 
sjmtax: 

operandi ' < ' operand2 
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The following code fragment demonstrates the relational less than operator: 
System. out. println ('A' < 'B'); 

The relational less than or equal to operator (<=) compares two values and 
returns a Boolean true value if the left operand is numerically less than or 
equal to the right operand. Otherwise, it returns false. That operator has 
the following syntax: 

operandi ' <= ' operand2 

The following code fragment demonstrates the relational less than or equal 
to operator: 

int score = 75; 

EXAMPLE System. out. println (score <= 49 ? "failed" : "passed"); 

The relational greater than operator (>) compares two values and returns a 
Boolean true value if the left operand is numerically greater than the right 
operand. Otherwise, it returns false. That operator has the following 
syntax: 

operandi ' > ' operandi 

The following code fragment demonstrates the relational greater than 
operator: 

double temp = 100.0; 

System. out. println (temp > 99.9 ? "boiling" : "coning to a boil"); 

The relational greater than or equal to operator (>=) compares two values of 
the same numeric type and returns a Boolean true value if the left operand 
is numerically greater than or equal to the right operand. Otherwise, it 
returns false. That operator has the following syntax: 

operandi ' >= ' operandi 

The following code fragment demonstrates the relational greater than or 
equal to operator: 
double temp = 100.0; 

System. out. println (temp >= 100.0 ? "boiling" : "coming to a boil"); 

The relational type checking operator (instanceof ) compares an object refer- 
ence to a reference type to see if the object is an instance of the type. A 
Boolean true value is returned if the object is an instance. Otherwise, false 
is returned. That operator has the following syntax: 
operandi 'instanceof operandi 




EXAMPLE 




EXAMPLE 



The left operand must be an object reference variable (which implies a ref- 
erence type), and the right operand must be a reference type. 



05 71710_CH03 11/21/01 12:03 PM Page 96 




96 Chapter 3: From Literals to Expressions 




\ I / The following code fragment demonstrates instanceof : 
01 System. out. println ("" instanceof String); 



EXAMPLE Shift Operators 

The shift operators shift the bits of their left operands either left or right 
using the amount specified by their right operands. Those operators are 
represented in source code by the «, », and »> tokens. 

For each operator, the operand types must be one of byte, character, inte- 
ger, long integer, or short integer. If the operand types don't match, the 
compiler will use a widening rule to convert the operand whose type repre- 
sents a more restricted range of values to the type of the other operand. 

The left shift operator («) left-shifts the bits of its left operand using the 
number of positions specified by its right operand. For each shift, a 0 is 
shifted into the operand's rightmost bit, and the leftmost bit is discarded. 
That operator has the following syntax: 

operandi '«' operand2 

The following code fragment demonstrates the left shift operator: 

int num = 35; 
num = num « 1 ; 

Figure 3.4 illustrates the left shift. A 0 is shifted into the rightmost bit, and 
the leftmost bit is discarded. The result can be interpreted as decimal num- 
ber 70 (46 hexadecimal). Left shift preserves negative numbers so that -i 
« 1 jdelds -2. 




EXAMPLE 
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Figure 3.4: A left shift operation is equivalent to (but faster than) multiply- 
ing by powers of 2. 

The signed right shift operator C») right-shifts the bits of its left operand 
using the number of positions specified by its right operand. For each shift, 
a copy of the sign bit is shifted to the right and the rightmost bit is dis- 
carded. That operator has the following syntax: 
operandi '»' operand2 
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EXAMPLE 



The following code fragment demonstrates the signed right shift operator: 

int num = -2; 
num = num » 1 ; 

Figure 3.5 illustrates the signed right shift. A 1 is shifted into the leftmost 
bit and the rightmost bit is discarded. The result can be interpreted as deci- 
mal number -1 (FF hexadecimal). Signed right shift preserves negative 
numbers. 
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Figure 3.5: A signed right shift operation is equivalent to (but faster than) 
dividing by powers of 2. 

The unsigned right shift operator (»>) right-shifts the bits of its left 
operand using the number of positions specified by its right operand. For 
each shift, a 0 is shifted into the leftmost bit and the rightmost bit is dis- 
carded. That operator has the following syntax: 
operandi '»>' operand2 

The following code fragment demonstrates the unsigned right shift 
operator: 

int num = -2; 
num = nun »> 1 ; 

Figure 3.6 illustrates the unsigned right shift. A 0 is shifted into the left- 
most bit, and the rightmost bit is discarded. The result is decimal number 
2,147,483,647 (the highest positive value of type integer). Unlike signed 
right shift, unsigned right shift does not preserve negative numbers. 
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Figure 3.6: An unsigned right shift operation is equivalent to (but faster 
than) dividing by powers of 2 for positive numbers only. 
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TIP 

Use the shift operators to quickly multiply and divide in computationally intensive graph- 
ics programs where performance is important. 



Unary Operators 

So far, only binary and ternary operators have been examined. The JLS 
also mentions a variety of unary operators. Those operators are represented 
by the +, -, ++, - - , ~, and ! tokens. The cast operator is also included as a 
unary operator. 

The unary plus operator (+) is a prefix operator that returns its operand. 
That operator has the following syntax: 

'+' operand 

The operand's type must be one of byte, character, double precision-floating 
point, floating-point, integer, long integer, or short integer. 

The following code fragment demonstrates the unary plus operator: 
System. out. println (+3); 

The unary minus operator ( - ) — also known as the negation operator — is a 
prefix operator that returns the arithmetic negative of its operand. That 
operator has the following syntax: 

' - ' operand 

The operand's type must be one of byte, character, double-precision, float- 
ing-point, integer, long integer, or short integer. 

The following code fragment demonstrates the unary minus operator: 
System. out. println (-3); 

The preincrement operator (++) is a prefix operator that first adds one to its 
operand (which must be a variable) and then returns the result. That oper- 
ator has the following syntax: 

'++' operand 

In a similar fashion, the predecrement operator ( — ) is a prefix operator 
that first subtracts one from its operand (which must be a variable) and 
then returns the result. That operator has the following syntax: 

' - - ' operand 

With either operator, the operand's type must be one of byte, character, 
double-precision floating-point, floating-point, integer, long integer, or short 
integer. 
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The following code fragment demonstrates the preincrement and predecre- 
ment operators: 
int num = 2; 

System. out. println (++num); // 3 is output. 
System. out. println (—num); // 2 is output 

The postincrement operator (++) is a postfix operator that saves the value of 
its variable operand in a temporary variable, adds one to the value in the 
variable operand, and returns the value of the temporary variable. That 
operator has the following syntax: 

operand '++' 

In a similar fashion, the postdecrement operator ( - - ) is a postfix operator 
that saves the value of its variable operand in a temporary variable, sub- 
tracts one from the value in the variable operand, and returns the value of 
the temporary variable. That operator has the following syntax: 

operand ' - - ' 

With either operator, the operand's type must be one of byte, character, 
double-precision floating-point, floating-point, integer, long integer, or short 
integer. 

The following code fragment demonstrates the postincrement and post- 
decrement operators: 
int num = 2; 

EXAMPLE System. out. println (num++); // 2 is output. 

System. out. println (num—); // 3 is output 

The bitwise complement operator (-) is a prefix operator that flips the bits 
of its operand — Is become Os and Os become Is. That operator has the fol- 
lowing syntax: 
'-' operand 

The operand's type must be one of byte, character, integer, long integer, or 
short integer. 

The following code fragment demonstrates the bitwise complement 
operator: 

System. out. println (-0xff00); 

The logical complement operator (!) is a prefix operator that flips the 
Boolean state of its operand — true becomes false and false becomes true. 
That operator has the following syntax: 

' ! ' operand 

The operand's type must be Boolean. 





EXAMPLE 
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EXAMPLE 



The following code fragment demonstrates the logical complement operator: 
System. out. println (Itrue); 

There is one final unary operator to examine — cast. That operator is either 
used to explicitly specify a narrowing rule (for primitive types) or to explic- 
itly convert a superclass type to a subclass type (for reference types). The 
cast operator has the following syntax: 

'(' typeldentifier ')' operand 

typeldentifier is the type to which operand is to be converted. If the conver- 
sion is legal, that will typically result in a new storage representation for 
the operand. For example, a floating-point value being converted to an inte- 
ger will have a different storage representation (from sign 
bit/exponent/mantissa to twos complement). 

The following code fragment demonstrates the cast operator: 
short s = (short) 50000; // 50000 is of type integer. 

The 32-bit integer 50000 is converted to a 16-bit short integer by truncating 
(throwing away) the upper 16 bits. 



Expressions 



An expression combines operators and/or operands into a unit of work. 
Those operands are expressions in their own right. Expressions range from 
the simplest literal and variable name to a complicated combination of 
operators and operands. Java uses expressions to create objects and arrays, 
to determine whether a loop statement should terminate or a decision 
statement should execute other statements, to pass values to and call meth- 
ods, to assign values to variables, and so on. Understanding how to use 
expressions is one of the more important aspects in a study of non-object- 
oriented language features. 

NOTE 

Expressions involve identifiers, types, literals, variables, separators, and operators. That 
is the reason those other topics were explored before expressions. 

At the Java Virtual Machine (JVM) level, an expression is evaluated by exe- 
cuting bytecode instructions that represent the various parts of the expres- 
sion. The result of the evaluation is either a variable, a value, or nothing 
(indicated by the void keyword). 
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\ I / The following code fragment demonstrates those three kinds of evaluation 
^4 results: 
int i; 
i = 1; 

// i = 1 is an expression which assigns one to variable j. This variable 
// is the result of the expression. 

int X =2; 

System. out. println (x + 1); 

// X + 1 is an expression which evaluates sub-expression x (by 
// retrieving its value), evaluates sub-expression 1 (by retrieving the 
// binary representation of this literal), adds this 1 to the value of x 
// and returns the result. This result (a value) is then passed to the 
// System. out. println () method call. 

void print (String s) { System. out. println (s); } 
print ("abc"); 

// print ("abc"); is an expression which calls a method named print() 
// with an "abc" string literal argument. This expression returns 
// nothing because the method call does not return anything (because it 
// is marked void) . 

In an expression, Java guarantees that each operator's operands are evalu- 
ated in a left-to-right evaluation order. The left-hand operand is evaluated 
before the right-hand operand. 

The following code fragment demonstrates a consequence of evaluating the 
left-hand operand before the right-hand operand: 

int X = 5; 
EXAMPLE int y = (X = 2) * x; 

System. out. println (y); 

What do you think gets printed? Give up? The answer is: 4. In the int y = 
( x = 2 ) * X ; expression, x = 2 is evaluated first because that subexpres- 
sion is contained in parentheses. That subexpression assigns 2 to x (a side 
effect of the overall expression). Now that its left-hand operand — the 
expression (x = 2) — has been evaluated, * evaluates its right-hand 
operand — the expression x — which contains 2. Therefore, 2 (the left-hand 
value) multiplied by 2 (the right-hand value) yields 4, which is assigned (by 
simple assignment operator =) to y. 
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An expression is evaluated in such a manner that certain operators evalu- 
ate their operands before other operators. That is known as precedence. 
Consider the previous example. If the parentheses were removed from x = 
2, how would the resulting y = x = 2 * x; expression evaluate? Because 
the multiplicative operator (*) has higher precedence than the simple 
assignment operator (=), * would first evaluate its left operand (2) and then 
its right operand (x — which contains value 5). Those values would be multi- 
plied to produce 10. Now, the rightmost simple assignment operator would 
evaluate its leftmost operand (x) by remembering that variable and then 
evaluate its rightmost operand (the value 10), which would subsequently 
assign to x. Finally, the leftmost simple assignment operator would evalu- 
ate its left operand (y) by remembering that variable and then evaluate its 
right operand (x — which contains 10) by retrieving the 10 stored in x. The 
value 10 would then assign to y. 

✓ For a quick summary of Java's operators and their natural precedence settings, see 
"Operator Precedence," p. 789. 

Natural precedence can be circumvented (as in the previous example) by 
using the parentheses separator. Java is designed so that it always evalu- 
ates an expression beginning with the subexpression in the innermost set of 
parentheses — in a left-to-right evaluation order (only). 

The following code fragment demonstrates evaluating an expression using 
natural precedence and also using a parentheses override: 
int i = 8 + 3 * 2; 

// 8 + 3 * 2 is naturally evaluated as if it was 8 + (3 * 2) because 
// multiplication has higher precedence. The result is 14, which is 
// assigned to j . 

int l< = (8 + 3) * 2; 

// (8 + 3) is evaluated first. Then, the result value is multiplied 
// by 2. The final result is 22, which is assigned to k. 



TIP 

There is a lot more that could be said about expressions — at least another 10 pages. 
You are strongly encouraged to read up on expressions in the JLS. You don't have to do 
that right now, but learning what the JLS has to say about expressions will most defi- 
nitely help you improve as a Java developer. 




EXAMPLE 
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What's Next? 



This chapter focused on hterals, variables, separators/operators, and 
expressions in a continued exploration of Java's non-object-oriented lan- 
guage features. Although the source code to a couple of applications was 
presented, that source code was quite limited. To liven things up, source 
code needs to include statements. The next chapter focuses on the state- 
ment feature and presents more complex source code. By the way, does 
Java consider a semicolon character to be a statement? To find out, turn to 
the next chapter. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 

NOTE 

The answers to the Reviewing It, Checl<ing It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 



Reviewing It 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. According to the JLS, the additive operators are associative when all 
operands are of the integer type. For example, 10 + 3-2, which is 
evaluated as ( 1 0 + 3) - 2, is equivalent to 1 0 + (3 - 2 ). However, the 
JLS also states that the additive operators are not associative when 
operands are either floating-point or double-precision floating-point. 
Why? 

2. Consider the following code fragment: byte bl =60; byte b2 = 50; 
byte b3 = (byte) (bl + b2); b2 += bl ;. Why is the cast operator 
required when assigning to b3 but not required when assigning to b2 
in the compound assignment b2 += bl? 

3. What is a primary expression? 

4. Suppose you declare and initialize an array consisting of two elements 
and then try to access an element using index 2. What happens? 

5. Is the expression null + " is null" legal or not, and why? 
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CHECK 



6. Is the variable declaration int \3063 = \u0beb; legal or not, and why? 

7. What is the difference between the expression ' A ' + 10 and the 
expression "A" + 10? 

8. Why is char c = ' \000a' ; incorrect? How can that be corrected? 



Checking It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. Which of the following character literals is incorrect? 

a. ' " ' 

b. '\n' 

c. ' ' ' 

d. None of the above 

2. Which of the following declarations is incorrect? 

a. int i = 0x70; 

b. Chan c = 60000; 

c. double d = 67L; 

d. None of the above 

3. An array index is what? 

a. An integer expression that identifies an array element 

b. Any numeric expression that identifies an array element 

c. a and b 

d. All of the above 
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4. Which operator is capable of performing a bitwise AND on its 
operands? 

a. + 

b. & 

c. && 

d. None of the above 

5. What is precedence? 

a. Natural evaluation order 

b. Forced evaluation order 

c. Left to right evaluation order 

d. None of the above 

6. What does the expression 1 / 0 produce? 

a. +Infinity 

b. An exception 

c. An overflow 

d. All of the above 

7. A binary operator has how many operands? 

a. 1 

b. 3 

c. 4 

d. 2 

8. An infix operator is what? 

a. Placed before its operands 

b. Placed after its operands 

c. Placed between its operands 

d. None of the above 

9. The code fragment int y = 1; int x = y++ + 3 + y; assigns what 
to X? 

a. 4 

b. 6 
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c. 5 

d. 7 

10. The result of an evaluation is what? 

a. A variable 

b. A value 

c. void 

d. All of the above 
True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. The expression float f = 20; is incorrect. 
True/False 

2. When using the conditional operator, it is legal for the operand 
appearing after the ? to be a short integer and the operand appearing 
after the : to be an integer. 

True/False 

3. The »> operator performs a signed right shift. 
True/False 

4. Assuming x is of type integer and initialized to some value, ++(x) is a 
valid expression. 

True/False 

5. 671 has the long integer type. 
True/False 

6. Parentheses is a separator, and comma is an operator. 
True/False 

7. Java's instanceof operator is a ternary operator. 
True/False 

8. The + token represents an overloaded additive operator. 
True/False 
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9. The shift operators can be apphed to all numeric operands. 
True/False 

10. Multiple simple variables can be declared by separating their names 
with commas. 

True/False 



APPLY 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. State the order of evaluation for each of the following expressions. 
Assume that x is an integer initialized to 1 . 

a. 20 + 2*3%6 - 10 

b. 10 / 3 - 6 * 15 

C. (8 + X) * 3 / ( (++X) ) 

2. Write a code fragment that declares a String array called names, ini- 
tializes that array to the "one", "two", and "three" literal strings, and 
prints the array's length. 

3. Write a code fragment that uses the conditional operator to output 
Hello if an integer variable called x contains 2 and output Goodbye if x 
contains some other value. 
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Statements 



This chapter ends our tour of Java's non-object-oriented language features 
with a thorough examination of statements. The discussions in this chapter 
define the statement feature and explore Java's various statements, includ- 
ing decision, loop, and loop control statements. 
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Types of Statements 



Programs evaluate expressions and execute statements. A statement takes 
an expression's value and uses that value as the basis for a meaningful 
action. For example, a statement can use a value to make a decision, use a 
value to control the number of times another statement executes, declare a 
variable and assign a value to that variable, and so on. The expression and 
statement features work in partnership to control a program's execution. 

Syntactically, a statement is expressed as: 

( decision \ loop \ loop control \ other \ block ) 

The syntax shows that a statement can be either a decision statement, a 
loop statement, a loop control statement, some other kind of statement, or a 
block of statements. Decision, loop, loop control, and other kinds of state- 
ments are explored in later sections. However, before we explore those 
statements, what is a block? 

A block groups zero or more statements between brace separators — { and }. 
(Normally, you would place two or more statements between the brace sepa- 
rators.) From the compiler's perspective, a block is a single statement that 
groups multiple statements and can appear anywhere a statement is legal. 
The compiler makes sure that a block's contained statements are executed 
in first-to-last and left-to-right order. 

Syntactically, a block is expressed as follows: 
' { ' [ statement ] ... ' } ' 

The block syntax, along with the previous statement syntax, shows that 
blocks can be nested: A block can be placed inside another block. 

The following code fragment demonstrates a block: 
{ 

System. out. println ("name = " + names [index]); 

System. out. println ("address = " + addresses [index++]); 

} 

The pair of System, out. println () Expression statements constitute a block, 
which begins with the { character and ends with the } character. The com- 
piler regards that block as a single statement. 

Blocks are needed because some kinds of statements (such as loop and deci- 
sion statements) perform an action on one and only one statement. For 
example, the While loop statement repeatedly executes a single statement. 
The only way to have While repeatedly execute multiple statements is to 
group those statements into a block: That block appears as a single state- 
ment to While, so all statements in the block execute. 




EXAMPLE 
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^ \ I / The following code fragment demonstrates a While loop statement execut- 
ly? ^1 ing a block: 

String [] names = { "John Doe", "Jane Smith" }; 
EXAMPLE String [] addresses = { "100 Oak St.", "213 Park Ave." }; 

int index = 0; 

while (index < names. length) 
{ 

System. out. println ("name = " + names [index]); 

System. out. println ("address = " + addresses [index++]); 

} 

Because of the block that follows While, both names and addresses print. 
However, if the braces separator is omitted. While would only execute the 
System. out. println ("name = " + names [ index] ); Expression statement. In 
that situation, index never advances, and While prints the names [0] ele- 
ment in an endless loop. That is an example of a logic error — an error that 
arises from program code not following the developer's original intentions. 

CAUTION 

Forgetting to place multiple statements in a blocl< is a common cause of logic errors. 



Decision Statements 



Computer programs are capable of making decisions. Such decisions are the 
result of decision statements. A decision statement either evaluates a 
Boolean expression and chooses which statement is executed next (based on 
the Boolean expression's true or false value) or evaluates a numeric expres- 
sion and finds an appropriate statement to execute (based on the numeric 
expression's value). 

Syntactically, a decision statement is expressed as follows: 
( If I If-Else I Switch ) 

If 

The If decision statement executes a statement conditionally. The following 
syntax expresses If in source code: 

'if ' ( ' expression ' ) ' 
statement 



If evaluates a Boolean expression. That expression returns either a true or 
false value. If true returns, statement executes. On the other hand, if false 
returns, the first statement to follow statement executes. The Boolean 
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EXAMPLE 



expression, which appears in all decision (except Switch) and loop 
statements, is commonly known as a condition. 

\ I / The following code fragment demonstrates an If decision statement: 

0^ double salary = 2100.0; // Monthly salary, 
double bonus = 50.0; 
int numSales = 553; 



if (numSales > 500) 
salary += bonus; 

The Boolean expression numSales > 500 evaluates to true because numSales 
contains value 553, which exceeds 500. The result: salary += bonus; exe- 
cutes. 

If-Else 

The If-Else decision statement executes either of two statements. The fol- 
lowing syntax expresses If-Else in source code: 

'if ' ( ' expression ' ) ' 
statementi 
' else ' 

statement2 

If-Else evaluates a Boolean expression. That expression returns either a 
true or false value. If true returns, statementi executes. Otherwise, 
statement2 executes. 

\ I / The following code fragment demonstrates an If-Else decision statement: 
\\K]f int month = 2; 
int day = 28; 



EXAMPLE 



if (month == 2 && day == 29) 
{ 

System. out. println ("Today is a leap day."); 

System. out. println ("It's time to buy a new vehicle."); 

} 

else 

System. out. println ("Today is just a regular day."); 

The Boolean expression month == 2 && day == 29 evaluates to false. As a 
result, Expression statement System. out. println ("Today is just a regular 
day. " ) ; executes. 
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The Dangling-Else Problem 

Java always associates an else with the previous if, unless if is placed 
inside a block and else is placed outside the block. Failure to remember 
that rule can lead to an interesting problem. 

Suppose you write the following code fragment: 
int X = 10; 
int y = 200; 



(X > 100) 
if (y > 50) 

System. out. println ("x exceeds 1C 



and y exceeds 50. " ) ; 



else 



System. out. println ("x is less than or equal to 100."); 

You might conclude that x is less than or equal to 100. prints. However, 
nothing prints because the compiler interprets the preceding code fragment 
as follows: 
if (X > 100) 
if (y > 50) 

System. out. println ("x exceeds 100 and y exceeds 50."); 

else 

System. out. println ("x is less than or equal to 100."); 

Basically, the If decision statement if ( x > 100) conditionally executes an 
If-Else decision statement. The else matches the nearest if: if (y > 50). 
You can modify that situation so that else matches if (x > 100), by placing 
the If decision statement if (y > 50) and the Expression statement 
System. out. println ("x exceeds 100 and y exceeds 50 ."); into a block, as 
the following code fragment demonstrates: 
if (X > 100) 
{ 

if (y > 50) 

System. out. println ("x exceeds 100 and y exceeds 50."); 

} 

else 

System. out. println ("x is less than or equal to 100."); 

When source code is improperly formatted, it might appear that an else 
matches up with a certain if — even when there is no match. That situation 
is commonly known in the computer science field as the dangling-else prob- 
lem. "Dangling elses" are not specific to Java programs: C and C++ pro- 
grams can also have that problem, because the C and C++ languages also 
define an else to match the nearest if. 
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Chained If-Else Statements 

If-Else decision statements can be chained, to make choosing from among 
multiple choices possible. The following syntax expresses that chaining in 
source code: 

'if ' ( ' expressioni ' ) ' 

statementi 
' else ' 

'if ' ( ' expression2 ' ) ' 

statement2 
' else ' 

'if ' ( ' expressions ' ) ' 
statements 

' else ' 

statement 

If expressioni evaluates to true, statementi executes. Otherwise, statement 
'if ' ( ' expression2 ' ) ' executes. Now, if expression2 evaluates to true, 
statement2 executes. Otherwise, statement 'if ' ( ' expressions ' ) ' exe- 
cutes. That process continues until either an if with a Boolean expression 
that evaluates to true is found or statement is reached. 

The following code fragment demonstrates several chained If-Else decision 
statements: 
double temp = 50.0; 

if (temp <= 0.0) 

System. out .print In ( "Frozen. " ) ; 

else 

if (temp >= 100.0) 

System. out . print In ( "Boiling . " ) ; 

else 

System. out. println ("Between frozen and boiling."); 

Following the variable declaration, the code fragment executes if (temp <= 
0.0). Because temp's value is greater than 0.0, that expression returns false 
and if (temp >= 100.0) executes. A false value returns because temp's value 
is less than 100.0. The final else is reached, and the System. out. println 
("Between frozen and boiling ."); Expression statement executes. 

Switch 

The Switch decision statement transfers control to one of several state- 
ments. The following syntax expresses Switch in source code: 
'switch' '(' expression ')' 
'{' 




EXAMPLE 
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[ 'case' tag ':' [ statement ... ] ] 
[ 'case' tag ':' [ statement ... ] ] 

[ 'default' ':' [ statement ... ] ] 

Switch evaluates expression, whose type must be byte, character, short 
integer, or integer. Switch takes the resulting value and searches through 
an optional list of cases to see if there is a case whose tag (a literal) 
matches the value. If such a case is found, all of its statements execute. 
Statements continue to execute until either all statements for all cases 
(including the default case) have executed (and the end of the Switch is 
reached) or either a Break loop control statement or a Return statement 
transfers control out of the Switch decision statement. If no case's tag 
matches the value, and if there is a default case, all of the default case's 
statements execute. 

The following code fragment demonstrates a Switch decision statement: 

System. out. print ("Press y for yes or n for no:"); 
int key = System. in. read (); 
switch (key) 
{ 

case 'y': System. out. println ("y was pressed."); 
break; 

case 'n': System. out. println ("n was pressed."); 
break; 

default : System. out. println ((char) key + " was pressed."); 

} 



CAUTION 

If you attempt to convert the preceding code fragment into an application, you will 
encounter a problem: System, in. read () has the potential to throw an exception. If 
you do not either handle the exception or "pass the buck," the compiler will generate 
an error. To "pass the buck," append throws java.io.IOException to your main() 
method signature. That allows the code that calls main( ) to deal with the exception. 
For example: public static void main (String [] args) throws java.io. 
lOException. The throws java.io.IOException will appease the compiler, and you 
should have no problems. (You will learn about exceptions and Throws clauses in 
Chapter 9.) 



The System . out . print ("Press y for yes or n for no: "); Expression state- 
ment prompts the user to press one of two keys. System, out. print () is simi- 
lar to System . out . println ( ) in that both Expression statements convert 
their arguments to Strings (unless those arguments are Strings) and then 
output characters contained in those Strings to the standard output device. 
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The difference is that System. out. println() also outputs a newline char- 
acter after outputting all other characters; that is not done by 
System. out . print ( ) . 

The int key = System . in . read ( ) ; Local variable declaration statement 
obtains the value of a key, typed on the keyboard, from the underlying oper- 
ating system's key buffer and stores that value in variable key. System . in . 
read ( ) obtains that value from the standard input device (which defaults to 
the keyboard) as an 8-bit byte, converts that value to a 32-bit integer, and 
returns the integer. 

✓ To learn more about System. out. print(), System. in. read(), and the standard input/output 
devices, see "Working with Streams," p. 634. 

The Switch decision statement evaluates the expression key. That evalua- 
tion returns key's value. Switch then searches for a case whose tag matches 
that value. First, key's value compares with ' y ' (after ' y ' converts from a 
16-bit character to a 32-bit integer). If there is a match. Expression state- 
ment System, out. println ("y was pressed" ); followed by Break loop control 
statement break; executes. Break terminates Switch's execution and causes 
execution to continue with the statement following Switch. If there is no 
match, key's value compares with ' n ' . Assuming a match, n was pressed 
prints, and the Switch decision statement exits. Otherwise, the default 
case's statements execute and Switch completes. 

Look carefully at expression (char) key + " was pressed. " First, key converts 
from an integer to a character, by way of the (char) cast operator. Then, that 
character converts to a String object. The contents of string literal " was 
pressed. " concatenate to that String object, and the resulting object returns. 
Without the (char) cast, the Unicode number of the key that was typed would 
convert to a character representation and those characters would print. For 
example, if A was typed on the keyboard, A was pressed . would print when 
the cast operator is used, and 65 was pressed . would print when the cast 
operator is not used. 

When you are working with a Switch decision statement, you can some- 
times design multiple cases to execute the same statements. Although such 
a design can be beneficial, it can also result in a logic error. 

The following code fragment demonstrates positive and negative aspects of 
having multiple cases execute the same statements: 
int key = System. in. read (); 

switch (key) 
{ 




EXAMPLE 
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case 'Y 

case 'y 

case 'N 

case 'n 



System. out. println ("Yes selected."); 



System. out. println ("No selected."); 
break; 

default : System. out. println {"?"); 



} 



The code fragment prints a message if the user types either Y or y, or types 
either N or n. If the user types either Y or y, System, out. println ("Yes 
selected. " ) ; executes. Furthermore, if the user types either N or n, 
System. out. println ("No selected."); executes. In either situation, execut- 
ing multiple cases is desirable because that eliminates code duplication. 

There is one problem with the code fragment. When the user types Y or y. 
Yes selected, followed by No selected, prints. That problem originates from 
not including a Break statement after System . out .println ( "Yes 
selected. " ) ;. 

CAUTION 

Failure to end a case with a Break statement causes execution to fall through to the 
next case's statement(s). Although that feature is beneficial (when used carefully), it 
also results in logic errors that are hard to find (when used improperly). 



Loop and Loop Control Statements 



A loop statement repeatedly executes another statement until some stop- 
ping condition is reached; each of those executions is known as an iteration. 

Syntactically, a loop statement is expressed as follows: 
( For I mile I Do ) 

Sometimes, it is necessary to break out of the current iteration and either 
cancel all future iterations or continue with the next iteration. That is 
accomplished by using loop control statements. 

Syntactically, a loop control statement is expressed as follows: 
( Break \ Continue ) 



For 

The For loop statement repeatedly executes another statement under the 
control of one or more loop variables. The following syntax expresses For in 
source code: 



for' '(' [ init ] ';' [ test ] ';' [ update ] ') 
statement 
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EXAMPLE 



The init clause is either a comma-dehmited hst of Expression statements 
(explored later in this chapter) or a Local variable declaration statement 
(also explored later in this chapter) and initializes one or more loop vari- 
ables that identify the current loop iteration. The test clause must be a 
Boolean expression and controls the duration of the loop. Finally, the update 
clause is a comma-delimited list of Expression statements and advances the 
loop variables so that they identify the next loop iteration. 

How does For work? First, one or more loop variables in the init clause ini- 
tialize. Second, the Boolean expression in the test clause evaluates (to see 
if a loop variable has reached a certain value). If that expression returns 
false, the loop terminates. However, if that expression returns true, statement 
executes. Subsequent to statement's execution, the update clause executes — to 
modify the contents of the loop control variable(s). Then, the Boolean expres- 
sion in the test clause re-evaluates. As long as that expression returns true, 
statement followed by the update clause re-execute. 

The following code fragment demonstrates a For loop statement: 

for (int i = 0; i < 10; 

System. out. println (i); 

The code fragment declares an integer variable, named i, that initializes to 
0. Following the declaration, i < 10 evaluates. If i (whose value is currently 
0) is not less than 10, the For loop statement exits. Otherwise, the 
Expression statement System. out. println (i) ; executes. Following that 
action, i++ executes — which adds 1 to the value stored in i (bringing the 
value of i to 1). Expression i < 10 evaluates for the second time. Because 
i's value is still less than 10, System. out. println (i) ; re-executes. 
Subsequently, i++ re-executes, bringing the value of i to 2. It will probably 
come as no surprise that i < 10 re-evaluates. When i contains 10, that 
Boolean expression returns false, and the For loop statement exits. 

Listing 4.1 presents the source code to PrintArgs, an application that pro- 
vides a more useful example of a For loop statement and is also useful in 
demonstrating command-line argument processing. 

Listing 4.1: PrintArgs. java. 
// PrintArgs. java 

class PrintArgs 
{ 

public static void main (String [] arguments) 
{ 

// For each argument, print out its value. 
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Listing 4.1: continued 

for (int i = 0; i < arguments. length; i++) 
System. out. println (arguments [i]); 

} 

} 

PrintAngs uses For to print all command-line arguments passed to that 
application. Suppose the SDK's j ava application launcher is used to run 
PrintArgs and the java PrintArgs First Second Third command line is spec- 
ified. Under that scenario, PrintArgs uses its For loop statement to print 
the following: 

First 

Second 

Third 

Now, suppose java PrintArgs First "Second Third" is specified. In that situ- 
ation, PrintArgs uses For to print the following: 

First 

Second Third 

Second and Third appear on the same line because both words (and the 
space that separates them) are placed between double quote characters. 
When i ava encounters those double quotes, it takes all characters between 
the quotes and places them into one String object. 

Finally, suppose the directory in which PrintArgs runs contains files 
PrintArgs . i ava followed by PrintArgs . class — and that Java PrintArgs * End 
is specified as a command line. Under the For loop statement's control, 
PrintArgs prints the following: 

PrintArgs. java 
PrintArgs. class 
End 

The asterisk (*) character represents all files in the current directory. When 
j ava encounters that character while processing a command line, it creates 
a String object for each file located in the current directory and adds that 
object to an array of Strings — to be passed to main( ) when that method is 
called. 

While 

The While loop statement repeatedly executes another statement while a 
Boolean expression evaluates to true. The following syntax expresses While 
in source code: 



while ' ' ( ' expression ' ) 
statement 
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EXAMPLE 



When execution enters the While loop statement, expression evaluates. If 
that Boolean expression returns true, statement executes. Otherwise, While 
exits. Subsequent to statement's execution, expression re-evaluates. As long 
as expression evaluates to true, statement re-executes. Because expression 
evaluates before statement, While is known as an entry -condition loop. 

The following code fragment demonstrates a While loop statement: 

int i = 0; 
while (i < 10) 

System. out. println (i++); 

The code fragment is functionally equivalent to for (int i = 0; i < 10; 
i++) System. out. println (i++) ;. Every For loop statement can be expressed 
as a While loop statement. The postincrement operator ensures that the 
loop does not become an infinite loop; without that operator, the While- 
controlled loop would never end. 

CAUTION 

Be careful to include some kind of loop termination condition in your loops. Othera/ise, 
they will run indefinitely. 

Listing 4.2 presents the source code to an application called ToBinary. That 
application uses a While loop statement to convert a decimal integer to 
binary. During conversion, each binary digit is represented as an integer 
and stored in an array. Following the conversion, a For loop statement 
prints those binary digits. 

Listing 4.2: ToBinary. java. 
// ToBinary. java 

class ToBinary 
{ 

public static void main (String [] args) 
{ 

int i = 0, num = 50000; 



int [] digits 
{ 

0, 0, 
0, 0, 



), 0, 0, 0, 0, 0, 
1, 0, 0, 0, 0, 0, 



), 0, 0, 0, 0, 
), 0, 0, 0, 0 



while (i < digits. length) 
{ 
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Listing 4.2: continued 

digits [i++] = num & 1 ; 
nun »= 1 ; 

} 

for (int j = digits. length - 1; j >= 0; ] — ) 
System. out. print (digits [j] + " "); 

System. out. println (""); 

} 

} 

While's loop converts num's value (50000) to its binary equivalent and dis- 
plays the resulting binary representation. Integer variable i controls the 
loop, which executes the block exactly 32 times — a number equal to the 
length of the digits array and also equal to the number of bits comprising 
variable num. 

The first block statement — Expression statement digits [i++] = num & 
1 ; — extracts the rightmost bit from num, by using the bitwise AND operator. 
That operator returns either integer 1 or 0, which the simple assignment 
operator stores in the digits array. The contents of loop variable i identify 
the current array element: i subsequently increments to identify the next 
loop iteration and the next array element. The second block statement — 
Expression statement num »= 1; — uses the signed right shift operator to 
shift all of num's bits one position to the right, so that the "next to right" bit 
can be examined on the next iteration. 

The For loop statement that follows While prints the contents of digits, so 
that the resulting binary representation can be seen. A careful examination 
of the block following While shows that the integer corresponding to the 
rightmost binary digit is stored in digit [0] and the integer corresponding 
to the leftmost binary digit is stored in digit [31 ]. Because binary digits 
must print in a left-to-right order (to properly show the binary representa- 
tion). For must provide array element indexes beginning at 31 and ending 
at 0. That is why For initializes j to digits. length - 1, keeps iterating as 
long as i is greater than or equal to 0, and decrements j using the post- 
decrement operator. 

Do 

The Do loop statement is practically identical to the While loop statement, 
except for Do executing its block prior to evaluating the Boolean expression. 
The following syntax expresses Do in source code: 
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'do' 

statement 
'while' '(' expression ')' ';' 

When execution enters Do, statement executes. Then, expression evaluates. If 
that Boolean expression returns true, statement re-executes. Otherwise, Do 
exits. Subsequent to statement's execution, expression re-evaluates. As long 
as expression evaluates to true, statement re-executes. Because expression 
evaluates after statement, Do is known as an exit-condition loop. 

The following code fragment demonstrates a Do loop statement: 

int i = 0; 
do 

System. out. println (i++); 
while (i < 10) ; 

The code fragment is almost identical (from a functional perspective) to the 
first example in the discussion of the While loop statement. The only differ- 
ence is that Do guarantees System. out. println (i++) ; to execute at least 
once. No such guarantee is made by While. 

Listing 4.3 presents the source code to an application called SquaresTable. 
That application uses a Do loop statement to display a table of squares for 
all integers ranging from 0 to 9 (inclusive). 

Listing 4.3: SquaresTable. java. 
// SquaresTable. java 

class SquaresTable 
{ 

public static void main (String [] args) 
{ 

int i = 0; 

System. out. println ("i\ti * i"); 
System. out. println ("-\t \n"); 

do 

System. out. println (i + "\t" + i * i); 
while (++i < 10) ; 

} 

} 

Integer variable i contains 0 before Do is entered. Immediately, Do's 
System. out. println (i + "\t" + i * i) ; Expression statement executes. 
Then, ++i < 10 evaluates: i increments from 0 to 1, and that value 
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compares with 10. Because 1 is smaller than 10, System. out. println (i + 
"\t" + i * i) ; re-executes. That activity continues until i reaches 10. The 
result is that both the values of i (from 0 through 9) and their squares 
print in tabular form. 

Floating-point values are sometimes used with equality operators in the 
Boolean expressions of Do, While, and For loop statements to determine 
when those loops end. However, that practice can result in loops that never 
end. 

The following code fragment demonstrates a Boolean expression, consisting 
of an equality operator and a floating-point value, used to create a never- 
ending loop: 
double f = 1 / 11.0; 




EXAMPLE 



do 
{ 

System. out. println ; 
f += 1 / 11.0; 

} 

while (f != 9 / 11.0); 

You might be tempted to think that the preceding loop will come to an end. 
However, that is not the case. The reason is that the floating-point values, 
resulting from 1 / 11.0 and 9 / 11.0, have an infinite number of digits 
after the decimal point, and a computer can store only a finite number of 
digits. Therefore, it is not true that the contents of f will exactly equal 9 / 
1 1 . 0 — after a sufficient number of additions. That problem can be solved by 
replacing ! = with <. 



CAUTION 

Be careful when using floating-point values with equality operators in Boolean expres- 
sions that determine when For, While, or Do loop statements terminate. Improper use 
could lead to loops that never end. 



Break 

The Break loop control statement terminates either a Switch decision state- 
ment or a loop statement. The following syntax expresses Break in source 
code: 

' break ' [ label ] ' ; ' 

The optional label identifies the outermost loop statement to be terminated 
and will be examined shortly. 
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The following code fragment demonstrates a Break loop control statement: 

while (true) 

{ 

System. out. print ("Press c to continue."); 

if (System. in. read () == 'c') 
break; 




EXAMPLE 



System. out. println ("c was pressed."); 

The code fragment uses a While loop statement to ensure that the user 
types c on the keyboard. While begins by prompting for that key. An If deci- 
sion statement then reads a key (via System. in. read ()) and compares that 
key with c (via == ' c ' )■ If c was typed, Break terminates the While loop 
statement and execution continues with System . out .println ( " c was 
pressed. " ) ;. 

Specifying Break without a label only causes the innermost loop to termi- 
nate. Execution then proceeds with the statement following the innermost 
loop. However, if Break is specified with a label, it is possible to break out 
of multiple loops. 

The following code fragment demonstrates breaking out of multiple loops: 
outerWhile : 

while (true) 
{ 

System. out. println ("\nTrue/False: Blocks can be nested. \n"); 



innerWhilel : 

while (true) 
{ 

System. out. print ("Enter t, f or any key to exit quit."); 



switch (System. in. read ()) 
{ 

case 't': System. out. println ("You are correct."); 
while (System. in. read () != '\n'); 
break innerWhilel ; 



case 'f 



System. out. println ("You are wrong."); 
while (System. in. read () != '\n'); 
break; 



06 71710_CH04 11/21/01 12:04 PM Page 125 




Loop and Loop Control Statements 125 



default : break outerWhile; 

} 

} 

System. out. println ("\nTrue/False: Loops are never " + 
"infinite. \n" ) ; 

innerWhile2: 

while (true) 
{ 

System. out. print ("Enter t, f or any key to exit quit."); 

switch (System. in. read ()) 
{ 

case 't': System. out. println ("You are wrong."); 
while (System. in. read () != '\n'); 
break; 

case 'f: System. out. println ("You are correct."); 
while (System. in. read () != '\n'); 
break innerWhile2; 



default : break outerWhile; 



} 



System. out. println ("Quiz has terminated."); 

The code fragment creates a two-question online quiz to demonstrate Break 
statements with labels. The quiz presents a pair of True/False questions in 
an outer While and awaits user input to each question in a pair of inner 
While loop statements. The user is expected to type t (for true), f (for false), 
or press any other key to exit the quiz. If the user types the correct choice, 
each Break (break innerWhilel ; and break innerWhile2; ) causes execution to 
leave the appropriate inner While and continue executing statements in the 
outer While. However, if the user presses any key apart from t or f, break 
outerWhile; causes execution to leave the outer While statement and termi- 
nate the quiz. 

Notice the outerWhile:, innerWhilel : and innerWhile2: labels. Each label is 
an identifier (which can never be a reserved word) immediately followed by 
a colon character. Java allows a label to immediately precede any statement 
(apart from a Local variable declaration statement). 
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Continue 

The Continue loop control statement terminates the current iteration of a 
loop statement and continues with the next iteration. The following syntax 
expresses Continue in source code: 
' continue ' [ label ] ' ; ' 

The optional label identifies the outermost loop statement that continues 
the next iteration. All innermost loop iterations are terminated. As with 
Break, that concept will be examined shortly. 

The following code fragment demonstrates a Continue loop control 
statement: 

int key, nunDigits = 0; 

System. out. println ("Press some keys:"); 

do 

{ 

key = System. in. read () ; 

if (key < '0' | | key > '9' ) 
continue; 

numDigits++; 

} 

while (key != '\n'); 

The code fragment counts the number of keys, representing digits, that are 
pressed. A Do loop statement makes sure that each key is examined before 
the end of input (represented by a newline character) is reached. If the 
Unicode value of a key is less than 0 or greater than 9, Continue causes the 
current iteration to cease (which means that numDigits++; is skipped) and 
expression key != ' \ n ' to re-evaluate. If that expression is still true, the 
end of input has not been reached and another iteration begins. 

Specifying Continue without a label only causes the innermost loop to ter- 
minate its current iteration (by skipping all remaining statements) and 
start a new iteration. However, if Continue is specified with a label, it is 
possible to terminate the current and future iterations of multiple loops 
and start a new iteration of the labeled loop. 

The following code fragment demonstrates terminating all inner loop itera- 
tions and continuing with the next outer loop iteration when a division by 
zero attempt is detected: 



EXAMPLE outerFor: 



for (int i = 0; i < 10; i++) 
for (int j = 0; i < 10; 
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{ 

if ((i - 3) == 0) 

continue outerFor; 

System. out. println {{float) j / (i - 3)); 

} 

When i contains 3, execution enters the inner For loop statement, where j 
initiahzes to 0, the i < 1 0 Boolean expression evaluates, and if ((i - 3) 
== 0) executes. The result of that latter execution is continue outerFor; 
transferring control to the outer For loop statement, where i++ increments 
from 3 to 4 and execution enters the inner For loop statement. That results 
in no attempts to divide by zero. 

All loops have the potential to become infinite — unless care is exercised to 
ensure that they terminate. Although Break and Continue help to make 
that termination possible, improper use of those statements can result in 
an endless loop. 

The following code fragment shows Continue preventing Break from ending 
a loop: 
int i = 0; 

while (true) 
{ 

System. out. println (i++); 
if (i != 100) 
continue; 

if (i > 5 && i < 10) 
break; 

} 

The code fragment's loop is infinite: (i != 100) causes Continue to execute 
until i equals 100. When that occurs, if (i > 5 && i < 10) is given a 
chance to execute. However, i > 5 && i < 1 0 always returns false because i 
contains a value greater than or equal to 100. 



CAUTION 

When working with {potentially) infinite loops, be careful to use a Break loop control 
statement to terminate those loops. {In many circumstances, you can also use Return.) 
Furthermore, be careful when using a Continue loop control statement, so that it 
doesn't bypass Break. Otherwise, the loop will most likely become infinite. 
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EXAMPLE 



Not all of Java's statements make decisions, repetitively execute statements 
in a loop, or control loops. Java provides other statements that accomplish 
different tasks, from doing nothing to synchronizing access to shared data. 

Syntactically, those other statements are expressed as: 
( Empty I Local variable declaration | Expression | Return | Throw | Try | 
Synchronized ) 

Empty 

The Empty statement consists of a semicolon character and doesn't do any- 
thing. However, that statement is useful when dealing with loop state- 
ments, where it's more important to evaluate the loop's Boolean expression 
than it is to execute another statement. 

The following code fragment uses While to flush (that is, empty) the key 
buffer. 

// Flush the buffer. 

while (System. in. read () != '\n') 



The purpose of the code fragment is to read and throw away all keys 
(ending with a newline) that are currently present in the key buffer. 
System . in . read ( ) returns the next key in the buffer, which compares with 
' \ n ' to determine whether a newline has just been read (which ends the 
loop). Subsequent to the comparison, the key is thrown away. Because the 
whole point to While is the flushing of the key buffer, and because all that 
work takes place in While's Boolean expression, there's no point in While 
executing a statement other than empty. 

Local Variable Declaration 

Chapter 3 introduced the variables feature. Among other things, that chap- 
ter mentioned the term local variable. A local variable is declared in a block 
(including the init clause of a For loop statement) by using a Local variable 
declaration statement. (That statement's syntax was presented in Chapter 
3.) Such a variable is said to be local to the block. 

The following code fragment declares a local variable in a block: 
{ 

int X = 2; 
EXAMPLE System. out. println (x); 
} 
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EXAMPLE 



Local variable x can be accessed from its point of declaration to the end of 
its block. In other words, the scope of that variable is its point of declara- 
tion to the end of the block in which the variable is declared. A local vari- 
able cannot be accessed before it is declared and at any point past its block. 

The following code fragment shows that a local variable has no scope prior 
to its declaration or beyond the end of its block: 

{ 

EXAMPLE System. out. println (x); // Error, 
int X = 2; 

System. out. println (x); 

} 

System. out. println (x); // Error. 

If a local variable is declared in a block and an attempt is made to rede- 
clare that variable in a nested block, an error occurs. 

The following code fragment tries to redeclare a local variable in a nested 
block: 

{ 

int i = 3; 
{ 

for (int i = 2; i < 10; i++) // Error. 
System. out. println (i); 

} 

} 

Because i is already declared by the time the Local variable declaration 
statement int i = 2; executes (in For's init clause), an error occurs. 

When a local variable has been declared, it must contain a value before it 
can be accessed. Otherwise, an error occurs because the variable has not 
been initialized. 

\ I / The following code fragment attempts to access an uninitialized local 
^1 variable: 

{ 

double amount; 

System. out. println (amount); // Error. 

} 

The preceding error is corrected by assigning a value to amount — as follows: 
{ 

double amount = 0.0; 
System. out. println (amount); // Error. 

} 




EXAMPLE 
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CAUTION 

An attempt to access a local variable outside of its scope, redeclare a local variable in 
a nested block, or access an uninitialized local variable results in a compiler error 
message. 




EXAMPLE 



Expression Statements 

Certain kinds of expressions are statements because they perform actions 
that "stand on their own." For example, it is possible to specify by 
itself, but X < 1 0 cannot stand alone. Expressions that double as state- 
ments are known as Expression statements, and they include assignment, 
preincrement, predecrement, postincrement, postdecrement, method call, 
and class instance creation. 

The following code fragment demonstrates the various Expression 
statements: 

X = 2; // Assignment 



++y 

- -z 

i++ 

k-- 



System.out.println ("ABC"); 
new Str-ing ( "Hello" ) ; 



/ Preincrement 

/ Predecrement 

/ Postincrement 

/ Postdecrement 

/ Method call 

/ Class instance creation 



4 To learn more about method calls, see "Methods," p. 148. To learn more about creating 
class instances, see "Objects," p. 156. 

Return 

The Return statement returns control, with an optional value, to a method's 
caller. 

✓ To learn more about Return, see "Methods," p. 148. 



Throw 

The Throw statement throws an object, describing an exception, to the 
JVM. 



✓ To learn more about Throw, see "Throwing Exceptions," p. 342 
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Try 

The Try statement executes a block. If one of the block's statements throws 
an object that describes an exception, the JVM will search for an exception 
handler to take care of the exception. 

✓ To learn more about Try, see "Throwing Exceptions," p. 342. 

Synchronized 

The Synchronized statement acquires a mutual-exclusion lock on behalf of 
the currently executing thread, executes a block, and then releases the lock. 
While a thread is executing statements in the block, no other thread can 
enter that block (and possibly corrupt data). 

✓ To learn more about Synchronized, see "Synchronization," p. 389. 



What's Next? 



If you've worked your way through this book and have reached this section, 
give yourself a pat on the back; it's an accomplishment. You've learned 
practically all there is to know about Java's non-object-oriented language 
features. By applying the knowledge from this and previous chapters, you 
are now in a position to write some simple Java applications. (Undoubtedly, 
you will develop some applications that are more interesting than the appli- 
cations that appear in this chapter.) Now that you have reached this point, 
you might think about checking out the Java Language Specification (JLS), 
to see what it says about Java's non-object-oriented language features. A 
study of relevant JLS topics will help reinforce what you have learned. (See 
the introduction for information on how to access the JLS.) 

When you finish investigating the JLS and reinforcing your skills with non- 
object-oriented Java, it's time to learn Java's object-oriented language fea- 
tures. The next chapter begins a multichapter tour of those features and 
also examines classes, fields, methods, and objects. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Appl3dng It 
activities. 

NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 
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REVIEW 



Reviewing It 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. Does every statement end with a semicolon character? 

2. Why is the in t x = x = 2; Local variable declaration statement legal? 

3. Why do you think a Switch decision statement's expression cannot be 
of long integer type? 

4. Does Java allow a Local variable declaration statement to be labeled? 
Why or why not? 

5. What happens if a default case is specified before other cases in a 
Switch decision statement? 

6. Is the following code fragment legal? Why or why not? 

for (boolean b = false; b != true; b = !b) System. out. println (b); 

7. Why doesn't Java allow uninitialized local variables to be read? (For 
example, in t x; System. out. println (x); is illegal.) 



Checl<ing It 



A second way to improve your understanding of the current chapter (and 
^^^^^ identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 



Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the 
question's four choices: 

1. Which of the following assertions is incorrect? 

a. A Switch decision statement can be created with no cases. 

b. A Break loop control statement can be used outside of a loop 
statement. 

c. System . in . read ( ) returns a key from the key buffer. 

d. f or ( ; ; ) ; is an infinite loop that keeps executing the Empty 
statement. 
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2. Which of the following assertions is correct? 

a. A local variable can be accessed past the block in which it is 
declared. 

b. Loops with Boolean expressions that use equality operators to 
determine whether the contents of floating-point subexpressions 
are either equal to or not equal to other floating-point subexpres- 
sions are always guaranteed to terminate. 

c. Expression statements and Local variable declaration statements 
cannot be intermixed (by using commas) in a For loop state- 
ment's init clause. 

d. None of the above. 

3. For is an example of what? 

a. An entry-condition loop 

b. An exit-condition loop 

c. A loop control statement 

d. All of the above 

4. Which of the following For loop statement assertions is incorrect? 

a. For consists of three clauses: init, test, and update, 
h. The init clause executes once per iteration. 

c. Semicolon characters are used to separate the test and update 
clauses from their respective preceding clauses. 

d. The update clause executes immediately after a statement and 
immediately before the test clause. 

5. Which of the following statements cannot be labeled? 

a. An Expression statement 

b. A Continue statement with a label 

c. A Switch decision statement 

d. A Local variable declaration statement 

6. Which of the following types is illegal for a Switch decision statement's 

expression? 

a. integer 

b. character 
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c. byte 

d. long integer 

7. Which of the following loop control statements is used to terminate a 
loop? 

a. Break 

b. Continue (with a label) 

c. a and b 

d. Continue 

8. Which of the following statements is used to prevent data corruption? 

a. Synchronized 

b. Try 

c. Throw 

d. None of the above 

9. Java's conditional operator is designed to resemble which decision 
statement? 

a. If 

b. If-Else 

c. Switch 

d. All of the above 

10. What is the result of not ending a Switch decision statement's case 
with a Break or Return statement? 

a. The default case is executed. 

b. The case automatically exits the Switch statement after the last 
of the case's statements has executed. 

c. Execution flows from the last statement of the previous case to 
the first statement of the following case (if present). 

d. None of the above. 
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True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. X++; is a statement. 
True/ False 

2. The default case must always be specified in a Switch decision 
statement. 

True/ False 

3. A block can be substituted for any single statement. 
True/ False 

4. Java never associates an else with the most recent if. 
True/ False 

5. An If decision statement unconditionally executes another statement. 
True/ False 

6. If-Else decision statements can be chained together. 
True/ False 

7. A local variable cannot be redeclared in a nested block. 
True/ False 

8. A Do loop statement evaluates a Boolean expression before executing a 
statement. 

True/ False 

9. A For loop statement can always be expressed in terms of While, local 
variable declaration, and expression statements. 

True/ False 

10. The following is valid Java code: 

int i; 

for (i = 2, System. out. println {"A"); i < 5; 
i++, System. out. println ("B")); 

True/ False 
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APPLY 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises. 

1. Write statements that accomplish the following tasks: 

a. Calculate the circumference and area of a circle whose diameter 
is 10. The circumference is defined as the mathematical constant 
pi (3.14159) multiplied by the circle's diameter. Also, the area is 
defined as pi multiplied by the square of the circle's radius. (A 
circle's radius is half its diameter.) 

b. Compute 8! (pronounced factorial). The factorial of some positive 
integer x (which is written as x! and pronounced x "factorial") is 
the product of positive integers ranging from 1 to x. For example, 
6! is equal to 6x5x4x3x2x1. (Factorials are commonly used 
in statistics.) 

c. Convert 37 degrees Celsius to Fahrenheit and 32 degrees 
Fahrenheit to Celsius. The formula to convert from Celsius to 
Fahrenheit involves dividing 9 by 5, multiplying the result by the 
Celsius value, and adding 32. Also, the formula to convert from 
Fahrenheit to Celsius involves subtracting 32 from the 
Fahrenheit value and multiplying the result by 5 divided by 9. 
(Use floating-point literals instead of integers.) 

2. What is wrong with the following code fi"agments? 

a. count = 5; while (count < 10); count++; 
b. 

int n = 1 ; 
switch (n) 
{ 

case 0: System. out. println ("zero"); 
break; 

case 1: System. out. println ("one"); 
case 2: System. out. println ("two"); 



for (int X = 3, x > 0, x++) 

System. out. println (x); 
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3. Rewrite the code fragment in 2b by using chained If-Else decision 
statements. (Assume that case 1 ends with a Break statement.) 

4. Write an apphcation called Reverse Int that prints the integer 
1234567890 in reverse. (When run, 0987654321 will print.) Use an 
array to hold the digits, a While loop statement to extract those digits, 
and a For loop statement to print those digits in reverse. (Hint: The 
program is similar in structure to the ToBinary application.) 

5. Using System . out . print ( ) and two sets of nested For loop statements, 
write an application that displays the following diamond pattern: 



* * * 
***** 

******* 
********* 
******* 
***** 

* * * 
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Classes and Objects 

Classes and objects form the basis of object-oriented programs. A class 
serves as an architectural blueprint — consisting of fields and methods — 
from which objects are created. Those objects model anything we want — 
from subatomic particles to employees to bank accounts to vehicles, to the 
entire universe. It's vital that you become familiar with classes and objects 
because you'll use those features in every object-oriented Java program that 
you write. 
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Classes 



A class introduces a developer-defined type into a program, by way of code 
implementation. That implementation manifests itself through fields and 
methods. Use the following class declaration syntax to specify a class in 
source code: 

[ 'public' ] [ ( 'abstract' | 'final' ) ] 'class' classldentifier 
'{' 

// field and method declarations 

'}' 

A class declaration begins with a header, minimally consisting of keyword 
class followed by classldentifier — an identifier that names the class (and 
cannot be a reserved word). Class names form the nouns of a Java program. 
Examples include Employee, Manager, Vehicle, Bicycle, Account, and 
SavingsAccount. 



TIP 

By convention, the first letter of a class name is capitalized. 



You can precede keyword class with keyword public and/or either keyword 
abstract or keyword final. 

• Specify public to make classldentifier visible to all classes in all 
packages. By default, classldentifier is visible only to classes in its 
package. (I discuss the concept of packages in Chapter 11.) 

• Specify abstract to prevent objects from being created from 
classldentifier. You would do that to distinguish a generic class (one 
in which objects should not be created) from a specific class. By 
default, you can create objects from classldentifier. (I discuss the con- 
cept of abstract classes in Chapter 7.) 

• Specify final to prevent classldentifier from being subclassed. In 
other words, final makes it impossible to specify a class that inherits 
from classldentifier. By default, classldentifier can be subclassed. (I 
discuss the concepts of subclasses and inheritance in Chapter 6.) 

Although the aforementioned concepts might seem confusing now, you will 
find that they make sense after you have worked your way through this 
chapter and the next few chapters. 



CAUTION 

Java imposes no restrictions on the ordering of public, abstract, and final. You can 
specify public abstract, public final, abstract public, or final public. (It's all 
the same to the compiler.) Also, if a class is declared public, that class must be 
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placed in a source file with the same name as the class. For example, a class named 
Rates must be placed in a file called Rates . j ava. In addition, only one public class 
can appear in a source file. 

A class declaration ends with a brace-delimited section in which fields and 
methods are declared. Those fields identify state, and those methods iden- 
tify behaviors. (You'll learn about state and behaviors as you continue read- 
ing this chapter.) 

The following code fragment declares a vehicle class: 

class Vehicle 

{ 

// Fields and methods are declared between { and }. 

} 

The Vehicle class declaration introduces a Vehicle type into a program. No 
fields and methods are declared within class Vehicle because I have yet to 
discuss those concepts. (You learn about fields and methods — and how to 
declare them — later in this chapter.) 

Vehicle's class declaration shows that Vehicle is only visible to classes 
declared in the same package, because public is not specified. Also, objects 
can be created from vehicle because abstract is not specified, and Vehicle 
can be subclassed because final is not specified. (You learn about objects 
and how to create them from classes, such as vehicle, later in this chapter 
and how to subclass classes in the next chapter.) 

Each class integrates fields and methods into a single unit. That integra- 
tion capability is known as encapsulation — one of three fundamental object- 
oriented programming principles. The other two principles are inheritance 
and polymorphism, which I discuss in later chapters. (To learn more about 
the inheritance and polymorphism principles, turn to Chapters 6 and 7, 
respectively.) 

The bringing together of data values (stored in fields) and methods that 
operate on those values marks a significant change in perspective from 
older structured languages, which emphasize separating data from the 
functions that operate on that data. Older structured languages view data 
values as existing to support functions. Encapsulation contrasts that view 
by regarding data values and functions (which are known as methods) as 
equals. 

Encapsulation is advantageous over the traditional structured view of data 
being subservient to functions because encapsulation more closely models 
the real world than the structured view. For example, think of a vehicle. Do 
you regard a vehicle primarily in terms of parking, accelerating, braking. 
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and so on; and secondly in terms of number of doors, colors, and so forth? If 
so, you are thinking from a traditional structured viewpoint. Or do you 
regard a vehicle as a distinct entity that combines behaviors (such as park- 
ing, accelerating, and so on) with state (such as color, number of doors, the 
presence of a CD player, and so on)? If you think of a vehicle as a combina- 
tion of behaviors and state, you are thinking from an encapsulation view- 
point. It is the entity that is important, not its behaviors! 

TIP 

To understand classes, you might find it helpful to think of a class as being equivalent 
to an architect's blueprint for a house. That blueprint encapsulates state (such as num- 
ber of doors, is there an attached garage, how many bathrooms are there, and so forth) 
with behaviors (the front door opens outwards, the house heats itself by way of an elec- 
tric furnace, the house protects itself by way of an alarm system, and so on). 



Fields 



Classes specify variables called fields. Each field represents an attribute, 
known as state, of either an object or a class. State examples include a 
boat's color, an employee's salary, a savings account's balance, an electron's 
spin rate, the number of animals residing at a zoo, and so forth. Declare a 
field in source code by using either of the following syntax examples: 

[ ( 'public' I 'private' | 'protected' ) ] 

[ ( 'final' I 'volatile' ) ] [ 'static' ] [ 'transient' ] 
typeldentifier fieldldentifier [ '=' expression ] ';' 

or 

[ ( 'public' I 'private' | 'protected' ) ] 

[ ( 'final' I 'volatile' ) ] [ 'static' ] [ 'transient' ] 
typeldentifier '[' ']' fieldldentifier 

I '=' '{' expression ',' ... ',' expression '}' ] ';' 

The first syntax refers to a non-array field declaration, and the second syn- 
tax refers to an array field declaration. Apart from some optional kejnvords, 
those syntax examples are identical to Chapter 3's variable declaration syn- 
tax examples. Like class names, field names form the nouns of a Java pro- 
gram. Unlike class names, however, field names begin with a lowercase 
letter. Examples include: salary, age, and temperature. 



TIP 

By convention, the first letter of a field name is lowercased, and the first letter of each 
successive word, making up that name, is uppercased. 
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^3 \ I / To learn how fields are declared, check out the following code fi"agment: 
ly class Calendar 

int dayOfWeek; 



EXAMPLE 



Static String [] monthNames = 
{ 

"January" , 
"February" , 
"March" , 
"April" , 
"May" , 
"June" , 
"July", 
"August" , 
"September" , 
"October" , 
"November" , 
"December" 

}; 

} 

Calendar declares two fields: a non-array integer dayOfWeek field and a 
String array monthNames field. Those fields represent a calendar's state and 
are declared between brace characters. 

TIP 

Java's standard class library includes a Calendar class in its java.util package. You 
will probably want to use that class in preference to your own. 



Access Specifiers 

Afield can be declared with an access specifier keyword: public, private, or 
protected. That keyword determines how accessible the field is to code in 
other classes. Access ranges fi-om totally accessible to totally inaccessible. 

If an access specifier kejrword is not present, Java assigns a default pack- 
age access to the field. Package access causes the field to be accessible to 
code within its class and to all classes within the same package. Any class 
not declared in the same package as the class that declares that field can- 
not access the field. For example, consider the dayOfWeek and monthNames 
fields in the previous code fragment's Calendar class. Neither field is 
declared with an access specifier keyword. As a result, those fields default 
to package access and can be accessed only by code in Calendar and other 
classes in Calendar's package. 
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EXAMPLE 




EXAMPLE 



When a field is declared private, only code contained in its class can access 
the field. That field becomes inaccessible to code in every other class (in all 
packages). 

The following code fragment declares a BankAccount class with a single pri- 
vate currentAmount field that can't be accessed by code outside BankAccount: 
class BankAccount 
{ 

private double currentAmount; 

} 

When a field is declared public, code contained in its class and every other 
class in the same package (and potentially in every other package) can 
access the field. Public access is the direct opposite of private access. 

The following code fragment declares a Clock class with a single public 
currentTime field that can be accessed by code in all classes (in all pack- 
ages): 

public class Clock 
{ 

public long currentTime; 

} 




EXAMPLE 



NOTE 

To make a field (such as currentTime) accessible to code in all classes (in all pack- 
ages), a class (such as Clock) must be declared public. Otherwise, the field can be 
accessed only by code in the current package's classes. 

Finally, when a field is declared protected, code contained in the field's 
class, all classes in the same package as that field's class, and all subclasses 
of that class (regardless of package) can access that field. 

The following code fragment declares an Employee class, with a single pro- 
tected salary field that can be accessed by code in all classes in Employee's 
package and all subclasses of Employee (regardless of package): 
class Employee 
{ 

protected double salary; 

} 



CAUTION 



Access specifier keywords cannot be included as part of a method's local variable and 
parameter variable declarations. 
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Modifiers 

A field can be declared with a modifier keyword: final or volatile and/or 
static and/or transient. Those modifiers turn a read/write field into a read- 
only field, ensure that shared fields are properly accessed by threads, turn 
an instance field into a class field, and prevent a field's value from being 
saved during object serialization. 

When a field is declared final, the compiler makes sure that the field is ini- 
tialized and subsequently treats the field as a constant. The compiler can 
perform internal optimizations on a program's bytecodes because it "knows" 
that the constant will not change. (By default, a field is read/write.) When a 
field is declared volatile, shared fields are guaranteed to be accessed in the 
order they appear in source code and the same number of times by each 
thread. (By default, a field is non-volatile.) 

✓ To learn more about volatile and threads, see "Synchronization," p. 389. 

When a field is declared static, all objects created from the class in which 
the field is declared share one copy of the field. Assigning a new value to 
that field causes all those objects to "see" the new value. (By default, each 
object has its own copy of a field.) 

Finally, when a field is declared transient, the field's value will not be 
saved during object serialization. (By default, the value will be saved.) 

✓ To learn more about transient and object serialization, see "Object Serialization," p. 659. 



CAUTION 

Modifier keywords cannot be included as part of a method's parameter variable declara- 
tions. Also, with the sole exception of final, modifier keywords cannot be included as 
part of a method's local variable declarations. 



Instance Fields 

If a field is declared without the static modifier keyword, that field is 
known as an instance field. Instance fields are associated with objects — not 
classes. When an instance field is modified, only the object associated with 
that field sees the change. An instance field is created when an object is 
created and destroyed when the object is destroyed. 

The following code fragment declares an instanceFieldDemo class and 
demonstrates the declaration of instance field d: 

class InstanceFieldDemo 
{ 




EXAMPLE 
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double d = 1234.5; 

} 

When the JVM creates an instanceFieldDemo object, it allocates memory for 
d and assigns 1 234 . 5 to that field. However, if an instance field isn't explic- 
itly assigned a value, the JVM zeroes the field's memory. That action estab- 
lishes a default value for the instance field. The way to interpret the 
default value depends on the instance field's type. For example, the default 
value of an instance field that refers to an object is null; the default value 
of a numeric field is 0 or 0.0; the default value of a Boolean field is false; 
and the default value of a character field is \u0000. 




EXAMPLE 



Class Fields 

If a field is declared with the static modifier keyword, that field is known 
as a class field. Class fields are associated with classes — not objects. When 
a class field is modified, the class (as well as any objects created from that 
class) "sees" the change. A class field is created when a class is loaded and 
destroyed if and when a class is unloaded. (Some JVMs might unload 
classes no longer needed by an executing program — freeing up memory.) 

The following code fragment declares a ClassFieldDemo class and demon- 
strates the declaration of class field count: 
class ClassFieldDemo 
{ 

static int count; 

} 

When the JVM loads ClassFieldDemo, it allocates memory for count and 
zeroes the field's memory. That action establishes a default value for count, 
which is interpreted as 0. 



Constants 

On occasion, you'll want to use read-only variables. A read-only variable is 
known as a constant. Constants must be explicitly initialized in source 
code. After constants have been initialized, their values cannot change. 

CAUTION 

Failing to initialize a constant when it is declared causes the compiler to report an 
error. 



A constant is declared with the final modifier keyword and is either an 
instance constant or a class constant. An instance constant is declared with 
the final keyword (and not also static): Each object gets a copy of the con- 
stant. In contrast, a class constant is declared with the final and static 
keywords and is shared by all objects. 
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EXAMPLE 



TIP 

From an efficiency perspective, it's better to use class constants. Tine reason is tliat a 
single copy of a class constant exists in memory (whicli results in a single memory allo- 
cation for the class constant), and a separate copy of an instance constant exists in 
memory for each object created from the class that declares the instance constant 
(which results in a separate memory allocation for each object's instance constant). 

The following code fragment declares a ConstantsDemo class and demon- 
strates the declaration of instance and class constants: 
class ConstantsDemo 
{ 

final int FIRST_CONSTANT = 1 ; 

final static int SECOND_CONSTANT = 2; 

} 

ConstantsDemo declares a pair of constants: FlRST_CONSTANT and SECOND_ 
CONSTANT. FlRST_CONSTANT is an instance constant because the static modifier 
keyword does not appear in its declaration. As such, it can be accessed only 
by objects created from ConstantsDemo. In contrast, SECOND CONSTANT is a class 
constant because the static modifier keyword appears in its declaration. 
That constant can be accessed by ConstantsDemo objects as well as the 
ConstantsDemo class. 

TIP 

By convention, constants are named using all uppercase letters. Also, underscore char- 
acters are used to separate words. Those conventions help identify constants in source 
code. 

Thus far, only non-array constants have been explored. However, you can 
also create array constants. And yet, when it comes to arrays, only array 
variables are constant: an array's component variables — the elements of the 
array — can still be changed. 

The following code fragment declares a Planets class with a pair of array 
constants and a modifyArrays() method. Within that method, the first line — 
innerPlanets [0] = outerPlanets [0]; — shows that array component vari- 
ables (innerPlanets [0]) can still be changed. However, the actual constant 
(innerPlanets) cannot be changed. Here is the source code: 
class Planets 
{ 

final static String [] innerPlanets = 
{ 

"Mercury", "Venus", "Earth", "Mars" 

}; 



07 71710_CH05 11/21/01 12:11 PM Page 148 




148 Chapter 5: Classes and Objects 



final static String [] outerPlanets = 
{ 

"Jupiter", "Saturn", "Uranus", "Neptune", "Pluto" 

}; 

void nodifyArrays () 
{ 

innerPlanets [0] = outerPlanets [0]; // Ok. 

// innerPlanets [0] now refers to "Jupiter" instead of "Mercury" 

innerPlanets = outerPlanets; // Error. 

} 

} 

Why would you use constants? Consider the following reasons: 

• In source code, it is easier and less error-prone to change a constant's 
initial value than to replace all occurrences of a hard-coded magic 
number. 

• Constants facilitate reading and understanding source code. For 
example, encountering ARRAY LENGTH in source code is more meaningful 
than encountering 15. (What does 15 mean?) 



Methods 



Classes specify code repositories, known as methods. Each method repre- 
sents either an object behavior or a class behavior. In some books that 
explore object-oriented programming, a behavior is referred to as a message 
that one object sends to another object. The object sending the message is 
known as the sender (or source), and the object receiving the message is 
known as the receiver (or target). An example of a message that an accoun- 
tant source object might send to a client target object is "give me your 
September receipts, for income tax purposes." In Java, you would send that 
message by having the accountant object make a call to the client object's 
method that returns receipt information. Before the call occurs, the accoun- 
tant object would pass some value to the method that identifies the month 
of September. As you read through this chapter, you will learn how to pass 
values to and call methods. For now, use the following syntax to declare a 
method in source code: 

[ ( 'public' I 'private' | 'protected' ) ] 
( [ 'abstract' ] | [ 'final' ] [ 'static' ] [ 'native' ] [ 'synchronized' ] ) 
type methodldentifier ' ( ' [ parameterList ] ')' 
■{■ 
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[ Statement ] ... 

'}' 

A method declaration begins with a signature and ends with a block of 
statements. The signature specifies an optional list of access specifiers, an 
optional list of modifiers, a return type (type), a method name 
(methodldentifier), and an optional parameter list (parameterList) between 
a pair of round brackets. The block of statements specifies those statements 
that execute when the method is called. Method names form the verbs of a 
Java program. Examples include accelerate, calculateBonus, and print. 

TIP 

By convention, the first letter of a method name is lowercased, and the first letter of 
each successive word making up that name is uppercased. 

The following code fragment declares a greeting ( ) method: 
void greeting {) 
{ 

System. out. println ("Hello!"); 

} 

greeting ( ) doesn't specify a parameter list and doesn't return a value, as 
indicated by the void reserved word. When called, that method calls 
System. out. println 0 to print Hello! on the standard output device. 

NOTE 

If a method does not return a value, specify void as the return type. Technically, void 
doesn't represent a type, but serves to identify that a method returns nothing. 

When a method is called, a list of argument values is passed to the method 
by way of variables declared in the parameter list. Each of those variables 
is known as a parameter. The number of arguments and the type of each 
argument must match the number of parameters and the type of each 
parameter (in a left-to-right order). 

The following code fragment declares a greeting ( ) method with a 
parameter list that consists of a single parameter: 
void greeting (String msg) 

EXAMPLE { 

System. out. println ("Hello! " + msg); 

} 

greeting ( ) specifies a parameter list consisting of one parameter — msg. 
When greeting ( ) is called with a single String argument, that argument is 
placed in msg. greeting ( ) and then calls System. out. println () to print 
Hello ! , followed by the contents of msg on the standard output device. For 
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EXAMPLE 



example, the greeting ( "This is me. ") method call results in Hello! This is 
me. printing. 

Parameters are considered local to a method. In other words, each parame- 
ter has a scope that's restricted to the method's block of statements. Also, 
the parameter is created each time a method is called and destroyed when- 
ever execution leaves the method and returns to the method's caller. 

To return a value to its caller, a method must make sure that the value 
being returned matches the signature's return type and must use a Return 
statement. The following syntax expresses Return in source code: 
'return' [ expression ] ';' 

The syntax shows that a Return statement does not need to return a value 
(resulting from the evaluation of expression) to a method's caller. That form 
of the Return statement can be used only by methods that use void to indi- 
cate no return type. Otherwise, an expression must be specified whose type 
matches the method's return type. 

The following code fragment declares a cube( ) method that uses a Return 
statement to return the cube of the argument value passed in n: 
int cube (int n) 
{ 

return n * n * n; 

} 

Because the type of expression n * n * n is integer, and because the return 
type is also integer, cube( ) compiles without any problem. 

Access Specifiers 

A method can be declared with an access specifier keyword: public, private, 
or protected. That keyword determines how accessible the method is to code 
in other classes, for calling purposes. Access ranges from totally callable to 
totally uncallable. 

If an access specifier keyword is not present, Java assigns a default pack- 
age access to the method. Package access causes the method to be callable 
from code within its class and from all classes within the same package. 
Code in any class not declared in the same package as the class that 
declares the method cannot call the method. For example, consider the pre- 
vious code fragment's cube( ) method. That method is not declared with an 
access specifier keyword. As a result, it defaults to package access and can 
be called only from code in whatever class cube( ) is declared and other 
classes in the same package as cube( )'s class. 
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When a method is declared private, only code contained in its class can call 
that method. The method becomes uncallable to code in every other class 
(in all packages). 

The following code fragment declares a Report class along with four meth- 
ods: generateReportO, doHeader(), doBodyO, and doFooter(). Apart from 
generateReport( ), all methods are private. 
EXAMPLE Class Report 
{ 

void generateReport () 
{ 

doHeader (); 
doBody 0; 
doFooter (); 

} 

private void doHeader () 

{ 

} 

private void doBody () 

{ 

} 

private void doFooter () 

{ 

} 

} 

Each of the methods doHeader(), doBody (), and doFooter () is known as a 
helper method because it is called from the non-private generateReportO 
method to help that method perform its task. If a method exists for the sole 
purpose of being called by other methods in a class (and is not designed to 
be called from outside that class), that method should be declared private. 

When a method is declared public, code contained in its class and every 
other class in the same package (and potentially in every other package) 
can call the method. As with public fields, a public method can be called 
only from code in all classes in the same package as the method's class, 
unless the class is also declared public. If a public method is declared in a 
public class, code in every class can call the public method. 

The following code fragment declares a MathTools class with a pair of public 
methods — cube( ) and square () — that can be called from code in all classes 
(in all packages): 
public class MathTools 
{ 




EXAMPLE 
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public double cube (double n) 
{ 

return n * n * n; 

} 

public double square (double n) 
{ 

return n * n; 

} 

} 

Finally, when a method is declared protected, code contained in the 
method's class, all classes in the same package as that method's class, and 
all subclasses of that class (regardless of package) can call that method. 

The following code fragment declares an Employee class with a single pro- 
tected calculateSalary 0 method that can be called from code in all classes 
in Employee's package and all subclasses of Employee (regardless of package): 
class Employee 
{ 

private double hoursWorked; 
private double hourlyRate; 

protected double computeSalary () 
{ 

return hoursWorked * hourlyRate; 

} 

} 

computeSalary 0 is declared protected because we don't want code in just 
any class to be able to call that method. The only classes whose code should 
be able to call computeSalary ( ) are all classes in the same package as 
Employee and Employee subclasses (which will typically override and cus- 
tomize that method) — regardless of the packages in which those subclasses 
are declared. For example, the salary for one kind of employee might con- 
sist of commission income, whereas the salary for another kind of employee 
might consist of the number of items produced in a given time period multi- 
plied by an item rate. Either kind of employee's salary computation would 
be modeled by its own computeSalary () method (that overrides Employee's 
computeSalary 0 method). You'll learn more about subclasses and method 
overriding in the next chapter. 

Modifiers 

A method can be declared with a modifier keyword: abstract or final and/or 
static and/or native and/or synchronized. Those modifiers treat a method as 
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abstract (with just a signature), turn an instance method into a class 
method, make it possible for a Java method to call native code located in a 
platform-dependent library, and restrict method execution to a single 
thread. 

When a method is declared abstract, it consists of only a method signature — 
there is no block of statements. Furthermore, the class in which the abstract 
method is declared must also be declared abstract. Finally, an abstract 
method cannot also be declared final, static, native, synchronized, or 
private. (By default, a method is not abstract: it requires a block of state- 
ments to execute.) 

When a method is declared final, the method cannot be overridden by a 
subclass. In other words, a subclass cannot introduce a new version of the 
method. (By default, a method can be overridden by a subclass.) 

When a method is declared static, the method can access only class fields; 
instance fields cannot be accessed. (By default, a method can access 
instance fields and class fields.) 

When a method is declared native, the JVM arranges for a native method 
call to result in execution passing to native library code. Although that 
capability can be useful (such as accessing a platform-specific feature), it is 
most undesirable from a platform-independent perspective — and can lead to 
robustness and security problems. The reason native methods are sup- 
ported is that portions of the standard class library (such as the file I/O 
portion) need access to the underlying platform to perform their tasks. (By 
default, a method is not native. This book does not discuss native methods, 
because that topic is beyond its scope.) 

Finally, when a method is declared synchronized, only one thread at a time 
can execute the method's block of statements. Other threads wanting access 
to the method are forced to wait until the currently executing thread 
returns from the method. (By default, a method is not synchronized.) 

Instance Methods 

If a method is declared without the static modifier keyword, that method is 
known as an instance method. Instance methods are associated with 
objects — not classes. Furthermore, instance methods can access either 
instance fields or class fields. 

The following code fragment declares a Truck class with a setColor( ) 
instance method that assigns the contents of parameter c to a color 
instance field: 



EXAMPLE 
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class Truck 
{ 

private Color color; 

void setColor (Color c) 
{ 

color = c; 

} 



TIP 

Java's this keyword identifies the current object in source code. You might find that the 
source code reads better if you prefix an instance field name with this and a period 
separator. For example, in the preceding code fragment, you could specify this. color 
= c; . In effect, when you prefix a field name with this (and a period separator), you 
are saying: "Access the specified field that belongs to this object." 



Class Methods 

If a method is declared with the static modifier kejrword, that method is 
known as a class method. Class methods are associated with classes — not 
objects. In addition, class methods can access only class fields. 

The following code fragment declares a CircleTools class with a 
circumference ( ) instance method that accesses class field Pi: 
class CircleTools 
{ 

final static double PI = 3.14159; 

static double circumference (double diameter) 
{ 

return PI * diameter; 

} 

} 

Attempting to access an instance field from a class method causes the com- 
piler to report an error. For example, assume that pi was not declared 
static in the CircleTools class in the preceding example. On encountering 
an attempt to access the pi instance field from circumference( ), the com- 
piler would report an error. Why? The compiler would not know which PI 
instance field to use. After all, each object gets its own copy of an instance 
field. 




EXAMPLE 
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CAUTION 

Attempting to access an instance field from a class method causes the compiler to 
report an error. In addition, keyword this cannot be used from inside a class method 
because a class method is associated with a class — not an object. 



Overloading Methods 

Declaring multiple methods (in the same class) that have the same name 
but different parameter lists is known as method overloading. When the 
compiler encounters a method call, it chooses the appropriate overloaded 
method (whose block of statements are to be executed) by comparing the 
method call's argument count and argument types with the parameter 
count and parameter types in each overloaded method. 

\ I / The following code fragment declares a Formatter class with a pair of over- 
^1 loaded format 0 methods: 
class Formatter 



EXAMPLE { 

void format {double d, int width, int precision) 
{ 




void format (int i, int width) 

{ 

} 

} 



Suppose the compiler encounters format (20, 5) ;. Because that method call 
consists of two arguments, and because each argument's type is integer, the 
compiler chooses the format (int i, int width) method as the method to be 
called. 



TIP 

For more examples of overloaded methods, check out the SDK documentation in regard 
to the StringBuffer class's various overloaded appendO methods. Also, investigate 
the documentation pertaining to the PrintStream class's overloaded print () and 
println{ ) methods. 



A method cannot be overloaded by only changing return types. If the com- 
piler detects two method declarations (in the same class) with the same 
names and parameter lists but different return types, it will report an 
error. 
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EXAMPLE 



The following code fragment declares a Cubes class with a pair of non- 
overloaded cubeO methods: 
public class Cubes 
{ 

public double cube (double n) 
{ 

return n * n * n; 

} 

public long cube (double n) 
{ 

return (long) (n * n * n); 

} 

} 

On encountering Cubes, the compiler reports an error because declaring a 
method that is identical to another method (in the same class) except for a 
different return type does not give the compiler enough information to tell 
those methods apart. How can the compiler distinguish between the preced- 
ing example's cube ( ) methods when confronted with cube (5.5)? 



Objects 



Just as an architect's blueprint forms the structural basis for a building, a 
class forms the structural basis for an object. An object models some nat- 
ural entity (such as a vehicle, a bank account, an animal, and so on) at run- 
time. How do you create an object from a class? Use a class instance 
creation expression, as the following syntax denotes: 
' new' constructor ' ; ' 

The class instance creation expression syntax begins with keyword new. 
That keyword compiles into bytecode instructions that tell the JVM to cre- 
ate an object, allocate memory for the object's instance fields, and initialize 
all bits in each instance field to zero. 

NOTE 

Although some books refer to new as an operator, the Java Language Specification (JLS) 
does not. Because I choose to follow the JLS's lead, you will not find me referring to 
new as an operator. 



How does new "know" what type of object to create? Keyword new gets type 
information from constructor, which is also the name of the object's class. 
After allocating and initializing instance field memory to zero, constructor 
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executes developer-specified instructions to complete the object's construc- 
tion. As soon as constructor finishes, an object exists, and its reference 
returns. 

NOTE 

Later in this cinapter, you will explore constructors in detail. For now, think of a construc- 
tor as a class name followed by a pair of round brackets. Also, it is not necessary to 
know what constitutes a reference. Some JVMs might implement a reference as a 
memory address, whereas other JVMs might choose unique integer numbers that index 
into a table of values. 

The following code fragment declares Employee and UseEmployee classes and 
creates an Employee object from UseEmployee's main() method: 
class Employee 



EXAMPLE { 



private double salary = 20000.0; // Default. 

void setSalary () 
{ 

this. salary = salary; 

} 

double getSalary () 
{ 

return salary; 

} 



} 



class UseEmployee 
{ 

public static void main (String [] args) 
{ 

Employee e = new Employee {); 

} 

} 

new Employee ( ) ; returns a reference to a newly created and initialized 
Employee object. (That object consists of a private salary field and a pair of 
package-access methods.) The reference subsequently assigns to Employee 
object reference variable e. To give you an idea of what that object and ref- 
erence variable look like in memory, Figure 5.1 conceptualizes object refer- 
ence variable e and the Employee object to which e refers. 
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object reference variable 




object 



Figure 5.1: A conceptual view of an Employee object and reference 
variable e. 

As with class names and field names, object reference variable names form 
the nouns of a Java program. Unlike class names, however, object reference 
variable names begin with a lowercase letter. Examples include: thermostat, 
myAccount, and currentUser. 

TIP 

By convention, the first letter of an object reference variable name is lowercased, and 
the first letter of each successive word, making up that name, is uppercased. 




EXAMPLE 



Accessing Fields 

When you declare a class, you'll find yourself writing code that accesses 
fields. How your code accesses a field depends on 

• Whether the field is an instance field or a class field 

• Whether code is attempting to access the field from an instance 
method or a class method in the same class as the field 

• Whether code is attempting to access the field from an instance 
method or a class method in another class 

The following code fragment declares FieldAccess and AnotherClass classes 
with methods that demonstrate various kinds of access to instance and 
class fields: 
class FieldAccess 
{ 

int instanceField; 
static int classField; 



void instanceMethod () 
{ 
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instanceField = 1 ; 
classField = 2; 

} 

static void classMethod () 
{ 

// The following assignment results in a compiler error. 
/ / Must write: 

// FieldAccess fa = new FieldAccess (); fa. instanceField = 3; 

instanceField = 3; 
ClassField = 4; 

} 

} 

Class AnotherClass 
{ 

void instanceMethod () 
{ 

FieldAccess fa = new FieldAccess (); fa. instanceField = 5; 
FieldAccess . ClassField = 6; 

} 

static void classMethod () 
{ 

FieldAccess fa = new FieldAccess (); fa. instanceField = 7; 
FieldAccess . ClassField = 8; 

} 

} 

FieldAccess declares integer fields instanceField and classField and meth- 
ods instanceMethod ( ) and classMethod( ). As you can see, instanceMethod ( ) is 
able to directly access both instanceField and classField, whereas 
ClassMethod can directly access classField but cannot access instanceField 
(because classMethod ( ) is associated with a class and instanceField is asso- 
ciated with an object). 

As with FieldAccess, AnotherClass also declares instanceMethod () and 
classMethod( ). Both methods are able to access instanceField by creating a 
FieldAccess object and referencing instanceField using that object reference 
(and a period separator). Also, both methods access classField by prefixing 
ClassField with FieldAccess (and a period separator). 

The example leads to the following field access rules: 

• To access an instance field from an instance method in the same class, 
you specify only the field's name. 
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• To access an instance field from a class method in the same class, you 
must create an object and access the field using the object reference 
(and a period separator). However, when you do that, you are access- 
ing the field only from the context of an object — not from the class 
method. 

• To access an instance field from an instance method in another class, 
you must create an object and access the field using the object refer- 
ence (and a period separator). However, when you do that, you are 
accessing the field only from the context of an object — not from the 
instance method. 

• To access an instance field from a class method in another class, you 
must create an object and access the field using the object reference 
(and a period separator). However, when you do that, you are access- 
ing the field only from the context of an object — not from the class 
method. 

• To access a class field from an instance method in the same class, you 
specify only the field's name. 

• To access a class field from a class method in the same class, you spec- 
ify only the field's name. 

• To access a class field from an instance method in another class, you 
must prefix the class field with the name of its class (and a period sep- 
arator). 

• To access a class field from an instance method in another class, you 
must prefix the class field with the name of its class (and a period sep- 
arator). 



CAUTION 

An attempt to directly access an instance field from a class method causes the com- 
piler to report an error. 



Shadowing 

Normally, a field is accessed from a method and declared in the same class 
as that field by specifying only the field's name. However, if the method also 
declares a local variable (or a parameter) with the same name as the field, 
an attempt to access the field by using only the field's name fails. Instead of 
accessing the field, the local variable (or parameter) is accessed. The access 
attempt fails because the local variable's (or parameter's) name shadows 
(that is, masks or hides) the field's name. To access the field name, you 
must refer to the field in a different way. For example, to distinguish an 
instance field from a same-named local variable (or parameter), specify 
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this, before the instance field's name. Similarly, to distinguish a class field 
from a same-named local variable (or parameter), specify the class name, 
followed by a period separator, before the class field's name. 

The following code fragment declares a ShadowDemo class with an 
accessFields( ) method that demonstrates shadowing: 
class ShadowDemo 



EXAMPLE { 

int X = 1 ; 



static int y = 2; 

void accessFields () 
{ 

double X = 3.0; 
double y = 4.0; 

// Output: X = 3.0 

System. out. println ("x = " + x); 

// Output: this.x = 1 

System. out. println ("this.x = " + this.x); 

// Output: y = 4.0 

System. out. println ("y = " + y); 

// Output: ShadowDemo. y = 2 

System. out. println ( "ShadowDemo. y = " + ShadowDemo. y) ; 

} 

} 

accessFields ( ) declares a pair of double-precision floating-point local vari- 
ables that have the same names as a pair of field variables. Furthermore, 
the method demonstrates those local variables shadowing the same-named 
fields. 

CAUTION 

Failure to recognize shadowing leads to various logic errors. 



Calling Methods 

When you declare a class, you'll find yourself writing code that calls meth- 
ods. How your code calls a method depends on 

• Whether the method is an instance method or a class method 

• Whether code is calling the method from an instance method or a class 
method in the same class as the method 
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• Whether code is calHng the method from an instance method or a class 
method in another class 

Regardless, code that calls a method is known as a method call and consists 
of the method's name along with a list of arguments. 

\ I / The following code fragment declares MethodCall and AnotherClass classes, 
with methods that demonstrate various kinds of calls to instance and class 
methods: 
EXAMPLE class MethodCall 
{ 

void instanceMethod () 

{ 

} 

static void classMethod () 

{ 

} 

void callFronlnstanceMethod {) 
{ 

instanceMethod (); 
classMethod (); 

} 

static void callFromClassMethod {) 
{ 

// The following method call results in a compiler error. 
// Must write: 

// MethodCall mc = new MethodCall (); mc . instanceMethod (); 

instanceMethod (); 
ClassMethod (); 

} 

} 

class AnotherClass 
{ 

void callFronlnstanceMethod {) 
{ 

MethodCall mc = new MethodCall (); mc. instanceMethod (); 
MethodCall. ClassMethod (); 

} 




void callFromClassMethod () 
{ 
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MethodCall mc = new MethodCall (); mc.instanceMethod (); 
MethodCall.classMethod (); 



} 



} 



MethodCall declares methods instanceMethod() and classMethod{), and meth- 
ods callFromlnstanceMethod( ) and callFromClassMethod( ). As you can see, 
callFromlnstanceMethod( ) is able to directly call both instanceMethod() and 
classMethod( ), whereas callFroniClassMethod( ) can directly call classMethod( ) 
but cannot call instanceMethod( ) (because callFromClassMethod ( ) is associ- 
ated with a class and instanceMethod( ) is associated with an object). 

As with MethodCall, AnotherClass also declares callFromlnstanceMethod( ) and 
oallFnortiClassMethod( ). Both methods are able to call instanceMethod( ) by 
creating a MethodCall object and referencing instanceMethod( ) using that 
object's reference variable (and a period separator). Also, both methods 
call classMethodO by prefixing classMethod() with MethodCall (and a period 
separator). 

The preceding example leads to the following method call rules: 

• To call an instance method from an instance method in the same class, 
you specify only the method's name. 



• To call an instance method from a class method in the same class, you 
must create an object and call the method using the object reference 
(and a period separator). However, when you do that, you are calling 
the method only from the context of an object — not from the class 
method. 

• To call an instance method from an instance method in another class, 
you must create an object and call the method using the object refer- 
ence (and a period separator). However, when you do that, you are 
calling the method only from the context of an object — not from the 
instance method. 

• To call an instance method from a class method in another class, you 
must create an object and call the method using the object reference 
(and a period separator). However, when you do that, you are calling 
the method only from the context of an object — not from the class 



• To call a class method from an instance method in the same class, you 
specify only the method's name. 



method. 



• To call a class method from a class method in the same class, you 
specify only the method's name. 
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• To call a class method from an instance method in another class, you 
must prefix the class method with the name of its class (and a period 
separator). 

• To call a class method from a class method in another class, you 
must prefix the class method with the name of its class (and a period 
separator). 



CAUTION 

When a method is called, Its local variables and parameters are created. The method's 
statements then access those variables. As soon as the method returns, those local 
variables and parameters are destroyed. Therefore, you cannot access a method's local 
variables or parameters from outside that method. If you attempt to access those vari- 
ables, you will receive compiler errors. 



EXAMPLE 



Chaining Method Calls 

Instance method calls can be chained together by using the technique of 
method call chaining. Method call chaining consists of multiple method 
calls chained together by intermediate period separators. Each method call 
(except for the last) returns a reference to the same object, and that refer- 
ence is used by the next method call. 

O \ I / Listing 5.1 presents source code for a ChainDemo application, which demon- 
si/'ISf strates method call chaining. 

Listing 5.1: ChainDemo. java. 
// ChainDemo. Java 

class ChainDemo 
{ 

public static void main (String [] args) 
{ 

new ChainDemo (). first (). second ().last (); 

} 

ChainDemo first () 
{ 

System. out. println ("First Method"); 
return this; 

} 



ChainDemo 
{ 

System 



second () 

.out. println ("Second Method"); 
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Listing 5.1: continued 
return this; 

} 

void last {) 
{ 

System. out. println ("Last Method"); 

} 

} 

ChainDemo produces the following output: 

First Method 
Second Method 
Last Method 



OUTPUT CliainDemo's [nain( ) method creates a new ClnainDemo object and passes that 

object reference to its first ( ) method during a call to that method. Because 
first 0 has a ChainDemo return type, it returns the current ChainDemo object 
reference via its return this; statement. That reference subsequently 
passes to the second ( ) method call, which is chained to the end of the 
first ( ) method call. As you can see, second ( ) is also declared with a 
ChainDemo return type and uses return this; to return the current ChainDemo 
object reference. Chaining continues with a chained method call to last( ), 
which also receives the reference, last ( ) can return that reference, but 
that's not required. After all, no method call needs to be chained to last ( ) . 



Call-by-Value 

During a method call, each of the method's arguments is passed to that 
method using an argument passing technique known as call-by-value (or 
pass-by-value, as that technique is also known). When an argument is 
passed call-by-value, the argument (which is an expression) is evaluated, 
and its value is copied into a memory location (known as a parameter) on 
what is known as the method call stack — discussed in the next section. If 
the argument is a variable, the contents of that variable (and not a refer- 
ence to the variable) are copied into the parameter. As a result, there is no 
way to modify the original argument from inside a method. You can modify 
only the copy of that argument that is stored in a parameter. 

Listing 5.2's CallDemo application demonstrates call-by -value. 

^ I / Listing 5.2: CallDemo. java. 
\\\m II CallDemo. java 



EXAMPLE 



Class CallDemo 
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Listing 5.2: continued 
{ 

public static void main (String [] args) 
{ 

int x1 = 3; 

methodi (x1); 

System. out. println (x1); 

int [] x2 = { 3, 2, 4 }; 
method2 (x2); 

for (int i = 0; i < x2. length; i++) 
{ 

System. out. print (x2 [i]); 

// The following If decision statement checks to see if 
// the last array element is being output. If it is not, 
// a comma followed by a space is output. This is done 
// to separate elements on the same line. 

if (i != x2. length - 1) 

System. out. print {", "); 



OUTPUT 



Static void methodi (int x) 



static void method2 (int [] x) 



X [0] 



} 



When run, CallDemo produces the following output: 

3 

0, 2, 4 

xi is not modified in methodi ( ) because it's passed call-by-value. As such, 
methodi ( )'s parameter x receives a copy of xl's value — not a reference to xl. 
Also, x2 cannot be modified in method2() because it's passed call-by- value. 
That means method2()'s parameter x receives a copy of the array reference 
stored in x2 — not a reference to x2. 
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Because method2( )'s parameter x contains a reference to the array that is 
also referenced by x2, it is possible to change array elements. That is why 
array element O's contents change from 3 to 0 inside method2( ) (which you 
see in the output). 

The same idea applies to passing other object references to methods. 
Because all object references are passed call-by-value, you cannot modify 
the reference in the method caller's variable. However, you can call object 
method and access object fields to modify the object. 




EXAMPLE 



Method Call Stack 

Methods can call other methods. When a method completes its execution, 
the JVM must return control to the calling method, at a point just after the 
method call. To help it "remember" the return point, the JVM uses a data 
structure known as the method call stack. 

The method call stack is like a stack of trays in a cafeteria. When a tray is 
washed, the newly cleaned tray is pushed onto the top of the tray stack; 
and when you need a tray, you pop the top tray off the stack by grabbing 
that tray — and so it is with method calls. 

Before the JVM allows execution to proceed from a method call to the 
method's block of statements, the JVM performs some housekeeping. First, 
it pushes the return point (in the caller) onto the top of the method call 
stack. Second, it copies argument values into newly created parameters. 
Third, the JVM transfers execution to the method's block of statements. If 
one of those statements calls another method, the same three things take 
place. To return control to the caller, the JVM pops the return point off the 
top of the method call stack and causes execution to continue with the 
statement located at the return point. 

The following code fragment declares three methods and two method calls 
that demonstrate the method call stack: 
public static void main (String [] args) 
{ 

method2 (); 

// Return point 1 

} 



static void method2 () 
{ 

methods (); 

// Return point 2 

} 
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static void methods () 

{ 

} 

When methods ( ) begins executing, the top item on the method call stack 
consists of return point #2. Furthermore, the next-to-top item consists of 
return point #1. When methods () exits, the JVM pops the top item from the 
method call stack and continues execution at return point #2 — in method2( ). 
The top item on the method call stack now consists of return point #1. 
When method2( ) exits, the JVM pops the top item from the method call 
stack and continues execution at return point #1 — main(). 



NOTE 

In addition to return points, the method call stack is also used to store local variables 
and parameters. Before the JVM calls a method, it allocates memory to hold the 
method's parameters and local variables. When the method returns, the JVM frees up 
that memory, which is why local variables and parameters exist only while a method is 
executing. 



Recursion 

Suppose you want to create a method that calculates a factorial. (You will 
need that capability if you work with permutations and combinations.) 
Given integer n, n's factorial (written n!) is the product of all integers from 1 
to n (inclusive). For example: 5! is equivalent to 1x2x3x4x5. (By the 
way, 0! is defined to be 1.) Your first approach to calculating n! will probably 
use a loop statement. The following code fragment demonstrates that 
approach: 

static int factoriall (int n) 
{ 

if (n < 0) // Negative factorials don't exist, 
return 0; 

int product = 1 ; 

for (int i = 2; i <= n; i++) 
product *= i; 

return product; 

} 

factoriall ( ) multiplies all integers from 1 to n's value in its For loop state- 
ment. The product returns to factoriall ( )'s caller. An iterative method 
(such as factoriall ( )) can always be replaced by a method that repetitively 
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calls itself (either directly or indirectly, by way of another method) to 
accomplish the same task. That capability is known as recursion. 

Recursion works by calling a method that "knows" how to solve the sim- 
plest (or base) problem. If the method is called with an argument that rep- 
resents the base problem, the method returns a result. However, if the 
method is called with an argument that represents a more complex prob- 
lem, the method divides that problem into a smaller problem that looks 
similar to the previous problem, by making a slight change to the problem 
and calling itself. Each method call factors the problem into something 
smaller until only the base problem results. Because the method knows 
how to solve the base problem, it returns a result (without any further 
recursion). That result returns to the previous method call, which uses the 
result to solve its problem. Then, that result returns to the previous 
method call, and so on. Finally, the original method call returns with the 
final result. The following code fragment demonstrates recursion: 
static int factorial2 (int n) 
{ 

if (n < 0) // Negative factorials don't exist, 
return 0; 

else 

if (n == 1) 
return 1 ; 

else 

return factorial2 (n - 1) * n; 

} 

It is not obvious, but factorial2() accomplishes the same task as factoniaH (). 
However, factorial2() uses recursion instead of iteration. That recursion is 
indicated by the presence of the f actorial2( ) method call. 

To see how factorial2() works, consider int x = factorial2 (5) ;. For 
starters, 5 passes as an argument to factorial2(), and that argument gets 
copied into parameter n. Inside factorial2(), the chained If-Else decision 
statement results in return factorial2 (n - 1) * n ; executing, which re- 
executes factorial2( ). Now, n contains 4. Once more, the chained If-Else 
decision statement results in return factorial2 (n - 1) * n; executing, 
f actorial2( ) re-executes, but with n containing 3. That cycle continues until 
n contains 1. At this point, return 1 ; (the base case) executes. The method 
call stack begins to unwind as method calls complete, and product values 
of 1, 2, 6, 24, and 120 return (in sequence). That activity can best be viewed 
figuratively; see the example in Figure 5.2. 
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factorial2 (5) 



n=5 

factorial2 (4) * 5 



n=4 

factorial2 (3) « 4 



n=3 

factorial2 (2) • 3 



n=2 

factorial2(1)«2 



n=1 

return 1 



: factorial2 (5) returns 120 



factorial2 (4) returns 24 



factorial2 (3) returns 6 



factorial2 (2) returns 2 



factorial2 (1) returns 1 



Figure 5.2: The recursive calculation of five factorial. 
CAUTION 

You must be careful to ensure that a recursive method has a stopping condition (such 
as factorial2()'s n == 1 condition). Without a stopping condition, the method call 
stack will eventually overflow, resulting in an out-of-memory situation. 

Why should you use recursion if iteration can alternatively be used? 
Computer scientists have found that recursion is an elegant tool for use 
with data structures that are recursively defined (such as trees). 



✓ To learn more about recursively defined data structures, see "Self-Referential Classes," p. 535. 



Constructors 

Creating an object is a two-step process. First, ke3rword new causes memory 
to be allocated. Second, a constructor is called to initialize the object's 
instance fields. Like non-constructor methods, a constructor can be declared 
with a parameter list and an optional access specifier. However, a construc- 
tor is always given the name of its class and never has a return type: There 
is no point in having a return type because new returns a reference to the 
newly created object, and there is no place to also return a value from the 
constructor. A constructor's code ensures that each newly created object is 
properly initialized before its reference returns. 
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EXAMPLE 




EXAMPLE 



CAUTION 

The compiler reports an error if a constructor is given a name other than the name of 
its class, a constructor is declared with a return type, or the constructor is declared 
abstract. 

The following code fragment declares class Def aultConstructor and demon- 
strates the default no-argument constructor: 
class Def aultConstructor 
{ 
} 

In the absence of any explicitly declared constructors, the compiler creates 
a default no-argument constructor. Therefore, the preceding code fragment 
is equivalent to the following code fragment, where a no-argument con- 
structor is explicitly declared: 
class Def aultConstructor 
{ 

Def aultConstructor () 

{ 

} 

} 

The compiler creates only a default no-argument constructor when no other 
constructors are explicitly declared in the class. If any other constructor is 
present, the compiler will not create a default no-argument constructor. 

The following code fragment declares class NoDef aultConstructor and 

demonstrates an explicitly declared constructor. It also demonstrates 

attempts to initialize an object using the explicitly declared constructor and 

initialize a second object using a default no-argument constructor (which 

doesn't exist): 

class NoDef aultConstructor 

{ 

private int i; 

NoDef aultConstructor (int i) 
{ 

this.i = i; 

} 



public static void main (String [] args) 
{ 

NoDef aultConstructor ndc1 = new NoDef aultConstructor (2); 
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// The compiler reports an error when it encounters the 
// following code because there is no default no-argument 
// constructor. 

NoDef aultConstructor ndc2 = new NoDef aultConstructor (); 

} 

} 



NOTE 

It might seem unusual to insert main( ) into a class from which objects are created. 
However, you typically insert main( ) into such a class to test that class, by running it 
as an application. After the class has passed its tests, you normally remove rtiain() 
from the class, and create another class with a main ( ) method that creates objects 
from the former class and drives the application. The new class is known as a driver 
class. The reason for creating a multiclass application with a single driver class is to 
force the user to run the application from only one class. (Why confuse the user?) For 
an example of a two-class application where one of the classes is the driver class, 
revisit the Employee and UseEmployee classes that were presented earlier in this 
chapter. 



Constructors initialize instance fields to explicit values. The compiler 
inserts initialization code that explicitly initializes instance fields into the 
constructor prior to any developer-specified code. 

The following code fragment declares classes Init and Showlnit and demon- 
strates the fact that a constructor has initialized an instance field to a 
specific value: 
class Init 
{ 

int i = 5; 

init 0 
{ 

System. out. println (i); 

} 



class Showlnit 
{ 

public static void main (String [] args) 
{ 

new Init ( ) ; 

} 

} 




EXAMPLE 
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When you run Showlnit (via java Showlnit), that apphcation prints 5. 
Obviously, i must have been initiahzed to 5 prior to the System. out. 
println (i) ; method call in Init () . 

Multiple constructors can be declared in a class. Having multiple construc- 
tors makes it possible to perform different kinds of initialization. 

^ \ I / Listing 5.3 introduces a Circles application, with a Circle class that 
S r iBr declares constructors for default and custom initialization. 

Listing 5.3: Circles, java. 
// Circles. java 

class Circle 
{ 

final static double PI = 3.14159; 

private double x, y, radius; 

Circle 0 
{ 

// System. out. println ("Before"); 
this (0.0, 0.0, 1.0); 
System. out. println ("After"); 

} 

Circle (double x, double y, double radius) 
{ 

this.x = x; 
this.y = y; 
this. radius = radius; 

} 

double area () 
{ 

return PI * radius * radius; 

} 

double circumference () 

{ 

return PI * radius * 2; 

} 



double getRadius ( 
{ 

return radius; 

} 
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Listing 5.3: continued 
double getx {) 
{ 

return x; 

} 

double getY {) 
{ 

return y; 

} 



class Circles 
{ 

public static void main (String [] args) 
{ 

Circle c1 = new Circle (); 

System. out. println ("X = " + d.getx ()); 

System. out. println ("Y = " + d.getY ()); 

System. out. println ("Radius = " + d.getRadius ()); 

System. out. println ("Area = " + d.area ()); 

System. out. println ("Circumference = " + d .circumference ()); 



Circle c2 = new Circle (20.0, 30.0, 50.0); 



System. out. println ( 

System. out. println ( 

System. out. println ( 

System. out. println ( 

System. out. println ( 



X = " + 02. getx 0); 

Y = " + 02. getY 0); 

Radius = " + c2.getRadius {)); 

Area = " + c2.area ( ) ) ; 

Circumference = " + c2. circumference ()); 



} 

When run, Circles produces the following output: 

^ After 

X = 0.0 
S/^^\J Y = 0.0 

Radius =1.0 

OUTPUT Area = 3.14159 

Circumference = 6.28318 

X = 20.0 

Y = 30.0 

Radius =50.0 

Area = 7853.974999999999 

Circumference = 314.159 
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Class Circle declares a pair of constructors. The first constructor takes no 
arguments and contains the following line of code: this (0.0, 0.0, 1.0);. 
Keyword this is used to call the second three -argument constructor. (Looks 
just like a method call.) 

There are a few rules to keep in mind when calling constructors via this ( ) : 

• You must specify this( ) to call a constructor. If you use the actual con- 
structor name, the compiler reports an error. For example, in Listing 
5.3, this (0.0, 0.0, 1 .0) ; is legal, but Circle (0.0, 0.0, 1.0); is not 
legal. 

• A constructor call, via this ( ) , must be the first developer-specified 
code in a constructor method. Otherwise, the compiler reports an 
error. (That is the reason for turning System. out. println ( "Before" ) ; 
into a comment.) 

• As a corollary to the first rule, because a constructor call must be the 
first line of code in a constructor, you cannot specify two (or more) 
constructor calls in a constructor. For example, you cannot specify 
this (0, 0, 1); this (60, 30, 30 );. If you try to specify multiple 
constructor calls, the compiler reports an error. 

• Finally, you cannot use this( ) to call a constructor from any method 
apart from another constructor. 



CAUTION 

The compiler reports an error if you try to call a constructor by specifying the actual 
constructor name, if this () is not the first code in a constructor, if multiple this ( ) 
calls appear in a constructor, or if this() appears in a non-constructor method. 



Singletons and Enumerated Types 

Why would you ever need to declare private constructors? It turns out that 
there are two situations in which private constructors are useful: singletons 
and enumerated types. 

Singletons 

When examining the source code to Java's standard class library, you'll 
probably encounter class declarations consisting of only a single constructor 
that's declared private. Furthermore, you might encounter a static method, 
named something like getlnstance( ), that is also declared in that class and 
that allows only a single object to be created from the class. If you should 
encounter such a class, welcome to singletons. 
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A class from which only a single object can ever be created is known as a 
singleton. The reason for not allowing more than one object to be created 
from a class is the cost and probability of error associated with the creation 
of multiple objects from that class. For example, suppose you declare a 
class that mimics a network connection, and you only need a single object 
to communicate with the network connection because establishing the con- 
nection is time-intensive and subject to error. For example, the connection 
might be down. 

The following code fragment declares a NetworkConnection class that demon- 
strates the creation of a singleton: 
public class NetworkConnection 
{ 

private static NetworkConnection singleton; 

private NetworkConnection () 
{ 

// The code in this constructor establishes the network connection. 
// This code deals with situations in which the connection is down. 

} 




EXAMPLE 



public static NetworkConnection getlnstance () 
{ 

if (singleton == null) 

singleton = new NetworkConnection (); 



return singleton; 

} 

} 

Because NetworkConnection declares a single private constructor, it is not 
possible to specify NetworkConnection nc = new NetworkConnection ( ) ; to 
create an arbitrary NetworkConnection object. Instead, only one instance of 
NetworkConnection can ever be created — the first time the getlnstance ( ) 
class method is called: NetworkConnection nc = NetworkConnection. 
getlnstance ( ) ; Subsequent calls to getlnstance ( ) will always return 
the same reference to the NetworkConnection object. 



NOTE 

To learn more about singletons and to find out when a singleton is not a singleton, read 
Sun's When Is a Singleton Not a Singleton? article (http: //developer, java. 
sun . com/ developer /technicalArticles/ Programming /singletons/). 
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EXAMPLE 



Enumerated Types 

Suppose you are called upon to write a Java program that models a circus. 
That program isn't sophisticated: It creates five constants, assigns one of 
those constants to a performer variable, and uses chained If-Else decision 
statements to identify the performer and print a suitable message. After 
some thought, you end up with an application called Circusl. 

Listing 5.4 presents source code to the Circusl application. 

Listing 5.4: Circusl . java. 
// Circusl .java 

class Perfornerl 
{ 

final static int ACROBAT = 1 ; 
final static int CLOWN = 2; 
final static int ELEPHANT = 3; 
final static int LION = 4; 
final static int MONKEY = 5; 

} 

class Circusl 
{ 

private int performer; 



public static void main (String [] args) 
{ 

Circusl c1 = new Circusl {); 
c1. performer = Performerl .CLOWN; 



if (c1 . performer == Performerl .ACROBAT) 

System. out. println ("Acrobat is now in the main ring."); 

else 

if (c1 . performer == Performerl .CLOWN) 

System. out. println ("Clown is now in the main ring."); 

else 

if (c1 . performer == Performerl . ELEPHANT) 

System. out. println ("Elephant is now in the main ring."); 

else 

if (c1 . performer == Performerl . LION) 

System. out. println ("Lion is now in the main ring."); 

else 

System. out. println ("Monkey is now in the main ring."); 

} 

} 
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EXAMPLE 



Circusi produces the following output: 

Clown is now in the main ring. 

5^ \[ Not bad! However, Circusi features a subtle problem: performer's integer 
~ " type. Suppose, by accident, -6334 gets assigned to cl .performer. Although 
OUTPUT that assignment is legal, because performer and -6334 both have the integer 
type, assigning -6334 to cl .performer makes no sense. After all, what per- 
former is represented by - 6334? In addition, because of the way the code is 
written. Monkey is now in the main ring, prints. But that string should 
only print when performer equals Performer. MONKEY, which has integer value 
5. How do we fix those problems? The answer: Use enumerated types. 

An enumerated type is a reference type with a restricted set of values. Each 
value is a reference to an object created from the enumerated type. 

Listing 5.5's source code to the Circus2 application demonstrates an enu- 
merated Pert ormer2 type. 

Listing 5.5: Circus2. java. 
// Circus2.iava 

class Performer2 
{ 

final static Performer2 ACROBAT = new Performer2 (); 

final static Performer2 CLOWN = new Perforner2 (); 

final static Performer2 ELEPHANT = new Performer2 (); 

final static Performer2 LION = new Performer2 (); 

final static Performer2 MONKEY = new Performer2 (); 

private Performer2 () 
{ 
} 

} 

class Circus2 
{ 

private Performer2 performer; 

public static void main (String [] args) 
{ 

Circus2 c2 = new Circus2 {); 
c2. performer = Performer2. CLOWN; 



if (c2. performer == Performer2. ACROBAT) 

System. out. println ("Acrobat is now in the main ring."); 

else 
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Listing 5.5: continued 

if (c2. performer == Performer2. CLOWN) 

System. out. println ("Clown is now in the main ring."); 

else 

if (c2. performer == Performer2. ELEPHANT) 

System. out. println ("Elephant is now in the main ring."); 

else 

if (c2. performer == Performer2.LI0N) 

System. out. println ("Lion is now in the main ring."); 

else 

System. out. println ("Monl<ey is now in the main ring."); 

} 

} 

Gircus2 closely resembles Circusl. The only major difference is the use of 
Perf ormer2 instead of int as performer's type. Only references to objects 
created from Performer2 can be assigned to performer. However, the only 
Perf ormer2 objects that can ever be assigned to performer are ACROBAT, CLOWN, 
ELEPHANT, LION, and IVIONKEY. 

Take a close look at the Perf ormer2 class. Notice the private no-argument 
constructor. Because that constructor is declared private, and there are 
no other constructors, it is not possible to create objects from Performer2. 
However, Perf ormer2 does declare several constant objects of type 
Perf ormer2. It is those constants that can be used in place of integer 
values. And, because you cannot create any other Perf ormer2 objects, the 
problems associated with Circusl disappear. 

Objects and Information Hiding 

Up to this point, the exploration of those Java language features that are 
used in the creation of object-based programs (that is, programs based 
solely on the first principle of object-oriented programming — encapsulation) 
has been the focus of this chapter. You've been introduced to a lot of con- 
cepts, and it's easy to become overwhelmed by all the jargon, rules, and 
syntax. For that reason, this section steps away from the details and looks 
at the big picture — by combining various details into an object-based pro- 
gram. Along the way, you'll learn about information hiding. 

\ I / You are called upon to model a book. Each book is represented by a title, an 
01 author, a publisher, and an ISBN (International Standard Book Number). 
At some future time, that book model will be incorporated into a library 
EXAMPLE model. How do you begin the project? 



You need to identify the nouns (which are used for class, object, and field 
names) and verbs (which are used for method names) from the preceding 
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problem specification. From that specification, the following nouns can be 
ascertained: book, title, author, publisher, ISBN, and library. Also, no verbs 
have been specified. 

Let's choose Book as the name of the book class. We'll choose title, author, 
publisher, and isbn as Book's fields. Each of those fields will be given type 
String, because each field is capable of holding textual information. Should 
those fields be instance fields or class fields? Because each book typically 
has, at minimum, a unique ISBN, we'll go with instance fields. Finally, 
because we will need to access those fields from another class that models a 
library, we'll allow those fields to have default package access. The follow- 
ing code fragment introduces the Book class: 
class Book 
{ 

String title; 
String author; 
String publisher; 
String isbn; 

} 

Now, suppose we declare a Library class with a rtiain( ) method that creates 
and initializes a Book object, as follows: 
class Library 
{ 

public static void main (String [] args) 
{ 

Book book = new Book ( ) ; 

book. title = "Java 2 By Example, Second Edition"; 

book. author = "Jeff Friesen"; 

book. publisher = "Macmillan Publishing"; 

book. isbn = "0-7897-2593-2"; 

System. out. println (book. title) ; 
System. out. println (book. author) ; 
System. out. println (book. publisher) ; 
System. out. println (book. isbn); 

} 

} 

Library's Book object access code does not look object-based. Fields are 
directly accessed in a manner reminiscent of a structured program. That 
direct access can introduce future maintenance problems — for those pro- 
grams that directly interact with Book's fields. For example, at some future 
time, it might no longer be desirable for publisher to be a String field. 
Instead, it might be decided that publisher should be changed to a 
Publisher field. In other words, publisher would refer to a Publisher object 
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that contains all kinds of publisher-related information. When that change 
is made, every program that directly accesses the publisher field must also 
be changed. 

Book can be modified so that code that creates and manipulates Book objects 
looks more object-based, and also so that future changes to Book don't break 
code that creates and manipulates Book objects. That is accomplished by 
declaring all fields private and introducing getter methods (that is, meth- 
ods whose names begin with the word "get") to return private field values. 
Those decisions lead to the resulting Book class: 
class Book 
{ 

private String title; 
private String author; 
private String publisher; 
private String isbn; 

Book (String title, String author, String publisher, String isbn) 
{ 

this. title = title; 
this. author = author; 
this. publisher = publisher; 
this. isbn = isbn; 

} 

String getTitle () 
{ 

return title; 

} 

String getAuthor () 
{ 

return author; 

} 

String getPublisher () 
{ 

return publisher; 

} 

String getlSBN () 
{ 

return isbn; 

} 
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By using a constructor, you have now initialized a Book object to a title, 
author, publisher, and ISBN when the object is created. Furthermore, the 
decision to hide Book's fields and use getters to return their contents helps 
to lessen the impact of changes to internal fields (like publisher) on pro- 
grams that use Book. The following Library class's updated Book-access code 
certainly looks more object-based: 
class Library 
{ 

public static void main (String [] args) 
{ 

Book book = new Book ("Java 2 By Example, Second Edition", 
"Jeff Friesen", 
"Macmillan Publishing", 
"0-7897-2593-2") ; 

System. out. println (book.getTitle ()); 
System. out. println (book.getAuthor ()); 
System. out. println (book.getPublisher ()); 
System. out. println (book.getlSBN ()); 

} 

} 

To see that the new Book class helps to keep code that uses the class from 
breaking when future changes are made to Book, let's introduce a Publisher 
class with name and address fields and make some changes to Book. First, the 
Publisher class appears in the following code fragment: 
class Publisher 
{ 

String name; 
String address; 

} 

Now, let's take a look at a Book class that absorbs Publisher: 

class Book 

{ 

private String title; 
private String author; 
private Publisher publisher; 
private String isbn; 

Book (String title, String author, String publisher, String isbn) 
{ 

this. title = title; 

this. author = author; 

this. publisher = new Publisher (); 

this. publisher. name = publisher; 
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this. publisher. address = "???" 
this.isbn = isbn; 



String getTitle () 
return title; 

String getAuthor () 
return author; 

String getPublisher () 
return publisher. name; 

String getlSBN () 
return isbn; 

} 

Book's getters have not changed, so the previous Library class's Book-access 
code does not need to be modified. Hiding the internal design of Book (and 
other classes) is known as information hiding. This section has yielded a 
brief taste of that important concept. To learn more about information hid- 
ing and to understand that encapsulation is not the same as information 
hiding, you are strongly encouraged to read the following Java World article: 
Encapsulation Is Not Information Hiding (http: //j avaworld.com/ 
i avawo rid/ iw-05 -2001 / iw-051 8-encapsulation_p. html). 



What's Next? 



While reading this chapter, you encountered the terms inherit, override, 
subclass, and subclassed. Those terms are associated with the second prin- 
ciple of object-oriented programming COOP): inheritance. The next chapter 
explores inheritance (from Java's point of view) and builds on Chapter 5's 
OOP foundation. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 
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NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 




REVIEW 



Reviewing it 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer. 

Can methods be declared in other methods? 

Why can't a class be declared abstract and final at the same time? 
What are two useful kinds of classes that declare private constructors? 



1. 
2. 
3. 
4. 



How does object-based programming (and, by extension, object-oriented 
programming) differ from traditional structured programming? 

5. From Java's perspective, what do you think "sending a message to an 
object" means? 

6. Why should fields be declared private to a class? 

7. In a narrative description of a problem, what would nouns suggest? 
What would verbs suggest? 

8. Why do you think constructors are not allowed to have return types? 

9. Structured programming languages make it possible to create global 
variables. One copy of each variable exists and is accessible to all func- 
tionality within a structured program. How might you achieve global 
variables in Java? 



Cliecl^ing it 



A second way to improve your understanding of the current chapter (and 
^^^^^ identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 



Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 
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1. The integration of fields and methods into a class is known as what? 

a. Inheritance 

b. Information hiding 

c. Encapsulation 

d. Shadowing 

2. A field that can be accessed by code in its class, all classes in the same 
package as its class, and all subclasses — regardless of package — is 
known as what? 

a. A public field 

b. A protected field 

c. A private field 

d. A package-access field 

3. Which of the following statements is true? 

a. A volatile field's value is not saved during object serialization. 

b. Anew object is created each time a singleton's "getlnstanceO " 
method is called. 

c. Final methods can be overridden by subclasses. 

d. Method call chaining requires a method to return a reference to 
the current object. 

4. Which of the following statements is false? 

a. A method declared in a different class from a private class field 
can access the class field by creating an object from the field's 
class and prefixing the class field with the object reference (and a 
period separator). 

b. A field name must be qualified with either a class name or an 
object reference, if an attempt is made to access the field from a 
method that declares a same-named local variable or parameter. 

c. An enumerated type is a reference type with a restricted set of 
values. 

d. No code can be placed before this( ) in a constructor. 
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5. The act of having a method invoke itself (either directly or indirectly, 
by way of another method) is known as what? 

a. Iteration 

b. Recursion 

c. A method call 

d. None of the above 

6. What does the JVM use to remember a method call's return point? 

a. A reference 

b. A queue 

c. A stack 

d. None of the above 

7. By default, a method is what? 

a. An instance method 

b. A class method 

c. A public method 

d. An abstract method 

8. By default, a field is what? 

a. A final field 

b. A transient field 

c. A class field 

d. A package-access field 

9. What does new Employee ( ) accomplish? 

a. Only allocates memory for an Employee object 

b. Only initializes an Employee object's instance fields 

c. Returns a reference to an initialized and newly created Employee 
object 

d. All of the above 
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10. What is this used for? 

a. Method call chaining 

b. Accessing instance fields shadowed by same-named local 
variables or parameters 

c. Calling constructors in the same class 

d. All of the above 

True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. A public class's package-access fields and methods can be accessed by 
code in all classes (in all packages). 

True/False 

2. Constructors must be named using the names of classes in which they 
are declared. Furthermore, constructors cannot have return types. 

True/False 

3. Final fields do not need to be initialized. 
True/False 

4. Instance fields are associated with classes. 
True/False 

5. It is more efficient to declare constants final static than to declare 
them final. 

True/False 

6. Java passes reference values, during a method call, to a method by 
using call-by-reference. 

True/False 

7. A method that does not return a value is declared void. 
True/False 

8. A method designed to help other methods is typically declared 
protected. 

True/False 
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9. Methods with the same names and parameter hsts, but with different 
return types, are overloaded. 

True/False 

10. Instance methods can access class fields and instance fields. 
True/False 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. Identify all the mistakes in the following application: 
// Mistakes. java 

abstract class Mistakes 
{ 

private int x; 



private void Mistakes (int x) 




static int count {) 
{ 

return; 

} 

int count (String msg) 
{ 

System. out. println (msg); 

} 

public static void main (String [] args) 
{ 

Mistakes m = new Mistakes (5); 

System. out. println (m. count ()); 

System. out. println (m. count ("# of mistakes")); 

} 

} 
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2. Declare an Employee class with the following capabilities: 

a. A private double-precision floating-point instance field called 
salary. 

b. A private String instance field called name. 

c. A constructor with a parameter list consisting of double salary 
and String name. The constructor must assign salary to the salary 
field and name to the name field. 

d. A no-argument constructor that calls the other constructor with 
35000.0 as the salary argument and "John Doe" as the name argu- 
ment. 

e. A getter instance method that retrieves the salary. 

f. A getter instance method that retrieves the name. 

g. A main ( ) method that creates two Employee objects. For each 
object, call the getter methods to print the salary and the name. 
(Use "Jane Doe" and 50000.0 as values for the other Employee 
object.) 

h. Save the Employee class in a file called Employee, java. 

3. Declare an Element class with the following capabilities: 

a. A private String instance field called name that identifies an ele- 
ment. 

b. A private integer class field called count that identifies the cur- 
rent number of created objects. 

c. A constructor with a parameter list consisting of String name. The 
constructor must assign name to the name field and increment 
count. 

d. A getter instance method that retrieves the name. 

e. A getter class method that retrieves the count. 

f. A main( ) method that creates three Element objects and initializes 
those objects to string literals "Hydrogen", "Helium", and "Oxygen". 
For each object, call the getter methods to print the name and the 
count. 

g. Save the Element class in a file called Element, java. 

Can you directly access count from main() (as in System, out. println 
(count) ;)? 
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4. Modify Exercise 3 as follows: first, rename Element . j ava to UseElement . 
java. Second, introduce a UseElement class. Third, move the main() 
method from class Element to UseElement. Can you directly access count 
from main ( ) (as in System . out . println ( Element . count ) ; )? Which class 
is the driver class? 

5. Write a recursive sum ( ) method that sums integers ranging from 1 to 
the contents of a single integer parameter — n. What happens if you 
call sum(l00000)? Can you make that method more efficient? 
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6 



Inheritance 

We explored the first OOP principle — encapsulation — in the preceding 
chapter, by way of classes and objects. The second OOP principle is 
known as inheritance. Java divides inheritance into implementation 
inheritance (by extending classes) and interface inheritance (by 
extending and implementing interfaces). This chapter begins its 
exploration of inheritance by introducing that concept and by focusing 
on implementation inheritance. A detailed look at the root of all 
Java classes follows. Then, interfaces and interface inheritance are 
explored. This chapter concludes its exploration of inheritance by 
discussing composition and its relationship to inheritance. 
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What Is Inheritance? 



We live in a world of relationships. For example, a butterfly and a beetle 
relate by virtue of being insects. Similarly, a boat and a car relate in that 
they are vehicles. Those relationship examples are known as "is a" relation- 
ships, in which one category is a specific kind of some other category. For 
example, a motorcycle is a specific kind of vehicle, a moth is a specific kind 
of insect, and an accountant is a specific kind of employee. When we talk of 
"is a" relationships, we are talking about inheritance — the capability to 
derive a less generic category from a more generic category. 

Inheritance promotes "is a" relationships through specialization. Given an 
existing category, one creates a new category that adds capabilities to the 
original category. In other words, the new category is a specialized sub- 
category of the original category. For example, by introducing mortgage- 
related details, a mortgage loan category is a specialized subcategory of a 
loan category. 

Inheritance can be visualized by using an inheritance chart. That kind of 
chart displays a hierarchy of categories that are related by inheritance. 
More generic categories appear in the upper reaches of the chart, and more 
specialized categories appear farther down. Also, arrows point from more 
specialized categories to more generic categories. Consider Figure 6.1's 
vehicle-based inheritance chart. 




Figure 6.1: An inheritance chart for vehicles shows the most generic cate- 
gory at the chart's top and less generic categories farther down. 

Inheritance charts display categories. Manifestations of the lowest cate- 
gories in an inheritance chart, known as entities, are what we interact with 
in everyday life. For example, consider your personal savings or checking 
account. That account entity is a manifestation of the savings- or checking- 
account category. In turn, the savings- or checking-account category is a 
specialized kind of bank-account category: The savings- or checking-account 



08 71710_CH06 11/21/01 12:14 PM Page 195 




What Is Inheritance? 195 

category inherits what it means to be a bank account from the bank- 
account category and adds savings or checking details. As a second exam- 
ple, that black Yamaha motorcycle entity parked on the street, which is 
shown in Figure 6.2, is a manifestation of the motorcycle category. 




Figure 6.2: A parked motorcycle entity is a manifestation of the motorcycle 
category. 

Entity and category are important words in regard to inheritance. We inter- 
act with entities (such as our savings account or a parked motorcycle), and 
we group entities into categories (such as a pair of butterflies being grouped 
into a butterfly category). Furthermore, we relate categories to other cate- 
gories through inheritance. To use an upside-down tree metaphor, in which 
the tree's root is on top of a branch hierarchy and the leaves are on the bot- 
tom, the tree's branches represent categories, and the leaves — instances of 
the lowest branches — represent entities. Figure 6.3 illustrates one such 
tree. Just turn the picture upside down and, apart from the leaves, you 
have a metaphor for an inheritance chart. 




Figure 6.3: Categories and entities relate to each other in a fashion that's 
similar to a tree's branches and leaves. Without the leaves, an upside-down 
tree is a perfect metaphor for an inheritance chart. 
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Categories have the capabihty of either inheriting from one (and only one) 
category or inheriting from two or more categories. In other words, a cate- 
gory can singly-inherit from one category or multiply-inherit from two or 
more categories. A visuahzation of single inheritance is provided in Figure 
6.1. In contrast, Figure 6.4 visualizes multiple inheritance. 



Vehicle 




AirVehicle LandVehicle WaterVehicle 




AmphibiousVehicle 



Figure 6.4: An inheritance chart for vehicles shows an amphibious vehicle 
category inheriting from both the land and water vehicle categories, which 
is an example of multiple inheritance. 

Figure 6.4 shows that an amphibious vehicle is both a land vehicle and a 
water vehicle. Therefore, an amphibious vehicle category should inherit 
those capabilities of what it means to be a land vehicle and a water vehicle. 
As you can see, the multiple inheritance concept is useful. 

Hopefully, you now possess an understanding of inheritance from a real- 
world perspective. But what is inheritance from an OOP perspective? In 
OOP terms, inheritance is the capacity for a type (known as a subtype) to 
extend another type (known as a supertype) through the addition of new 
capabilities and/or the redefinition of the supertype's existing capabilities. 

Inheritance has traditionally been seen as a class implementation of a type 
extending other class implementations of a type. That viewpoint, made 
popular by C-n-, implies a class either singly- or multiply -inherits fields 
and methods from other classes. 

The class implementation approach to inheritance suffers from certain 
problems that tend to arise when one class inherits from multiple classes. 
Those problems (discussed later in this chapter) lead to compilation diffi- 
culties. Fortunately, it is possible to circumvent those compilation difficul- 
ties by taking a different approach to inheritance. That alternate approach 
offers a non-implementation viewpoint to inheritance and is known as 
interface inheritance. 

Java's designers recognized the need to support inheritance from the 
implementation and interface perspectives and added support for both 
kinds of inheritance to Java. This chapter examines that support. To begin, 
it focuses on implementation inheritance. 
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EXAMPLE 



Implementation Inheritance 

The capacity for a type implementation (that is, a class) to extend one or 
more type implementations (that is, classes) is known as implementation 
inheritance. That kind of inheritance is present in the C++ language. 
Because Java only supports implementation inheritance in a limited fash- 
ion, where a class can extend one and only one other class, Java's support 
for implementation inheritance is known as single implementation inheri- 
tance. The following syntax expresses single implementation inheritance in 
source code: 

'class' classldentifierl 'extends' classldentifier2 
'{' 

/ / Class members 

'}' 

Class classldentifierl extends class classldentifier2. In other words, 
classldentifierl inherits capabilities — expressed through fields and 
methods — from classldentifier2. The class represented by classldentifierl 
is known as a subclass, a derived class, or a child class; the class repre- 
sented by classldentifier2 is known as a superclass, a base class, or a 
parent class. 

Keyword extends presents all fields and methods that are declared in a non- 
final superclass (including that superclass's superclasses) to the subclass. 
The subclass can directly access all inherited nonprivate fields and meth- 
ods; it can access private fields and methods only indirectly, by calling any 
nonprivate superclass methods. 

CAUTION 

The compiler reports an error when it detects either an attempt to extend a final super- 
class (that is, a class declared with the final keyword) or an attempt, by a subclass, 
to access a superclass's private members. 

You are required to write a program that models three-dimensional geomet- 
ric shapes. To begin, you plan to focus on points and spheres. You could cre- 
ate separate unrelated classes that represent point and sphere categories. 
Or, by realizing that a sphere is nothing more than a point with radius, you 
could take advantage of single implementation inheritance to provide a 
point-sphere relationship. The ShapesSD application source code in Listing 
6.1 demonstrates. 

Listing 6.1 ShapesSD. java 
// ShapesSD. java 



class Point 
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Listing 6.1 continued 
{ 

private double x, y, z; 

Point (double x, double y, double z) 
{ 

this.x = x; 
this.y = y; 
this.z = z; 

} 

double getx {) 
{ 

return x; 

} 

double getY {) 
{ 

return y; 

} 

double getz {) 
{ 

return z; 

} 



class Sphere extends Point 
{ 

private double radius; 

Sphere (double x, double y, double z, double radius) 
{ 

super (x, y, z); // Call Point (double x, double y, double z). 
this. radius = radius; 

} 

double getRadius () 
{ 

return radius; 

} 
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Listing 6.1 continued 
class ShapesSD 
{ 

public static void main (String [] args) 
{ 

Sphere s = new Sphere (1.0, 2.0, 3.0, 4.0); 



System. out. println (s.getx () 

System. out. println (s.getY () 

System. out. println (s.getz {) 

System. out. println (s.getRadius ()); 



OUTPUT 



} 

When run, ShapesSD produces the following output: 

1.0 
2.0 
3.0 
4.0 

ShapesSD consists of classes Point, Sphere, and ShapesSD. Point describes what 
it means to be a point, which is nothing more than an (x, y, z) coordinate 
triple expressed as double-precision floating-point values. 



NOTE 

Java includes a Point class in its standard class library. If you would like to investi- 
gate, that class is located in the java.awt package. 



Sphere describes what it means to be a sphere — a point with radius. When 
ShapesSD's main 0 method executes Sphere s = new Sphere (1.0, 2.0, 3.0. 
4.0) ;, a multilayered Sphere object is created. The inner layer consists of 
the structure established by Point, and the outer layer consists of the struc- 
ture established by Sphere. Figure 6.5 illustrates that object. 

According to Figure 6.5, the inner Point layer records the location of the 
Sphere's origin, and the outer Sphere layer records the Sphere's radius. 
Furthermore, the dashed lines indicate access to methods. Using s, the 
Point layer's getx( ), getY( ), and getz( ) methods can be called; only those 
methods can access the x, y, and z fields, respectively. (To keep the illustra- 
tion simple, constructors are not shown.) Figure 6.5 also shows that sub- 
classes (such as Sphere) are larger than superclasses (such as Point). That is 
due to the additional members — fields and methods — introduced by sub- 
classes. 
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ED 




-radius 4.0 



getRadiusO" 



Figure 6.5: A multilayered Sphere object. 

Unlike single implementation inheritance, Java does not support multiple 
implementation inheritance (that is, the inheritance of implementation from 
multiple classes) because that kind of inheritance can lead to confusing 
problems for the compiler. For example, suppose two base classes declare a 
field with the same name but different types. Which field would the sub- 
class inherit? The same idea holds with methods. If two methods with the 
same name but different parameter lists and/or return types appear in two 
base classes, which method does the subclass inherit? 



Calling Superclass Constructors 

In Listing 6.1, Sphere's constructor contains super (x, y, z) ;. Furthermore, 
a comment indicates that the code fragment calls the Point (double x, 
double y, double z) constructor. Java provides kejrword super to allow a 
subclass constructor to call a superclass constructor, which gives the super- 
class constructor a chance to initialize the superclass layer's private fields. 

Suppose Sphere's constructor is modified to not include super (x, y, z);, 
and suppose an attempt is made to compile the source code. What happens? 
The compiler reports an error. The reason is due to Java requiring a sub- 
class constructor to always call a superclass constructor (unless a call to 
another subclass constructor, via this(), is present), whether or not source 
code explicitly specifies super( ). If one does not specify super ( ) (and this( ) 
is not used to call another subclass constructor), the compiler inserts super 
( ) ; at the beginning of a subclass constructor, to call the superclass's 
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default no-argument constructor. For example, if Sphere's constructor did 
not contain super (x, y, z) ;, the compiler would need to insert super ();, 
to call Point ( ) . Because Point does not have a Point ( ) ; constructor, the 
compiler would have no choice but to report an error. 

CAUTION 

If a superclass declares a constructor with at least one parameter, the compiler does 
not generate a default no-argument constructor for that class. Furthermore, if a sub- 
class constructor does not explicitly call the superclass's constructor, the compiler 
assumes that the subclass constructor will call the superclass's default no-argument 
constructor. Because the superclass does not have such a constructor, the compiler 
reports an error. 

When calling superclass constructors, keep the following rules in mind: 

• A superclass constructor can be called only from a subclass construc- 
tor. That call cannot be made from any other subclass method. 

• A superclass constructor call requires the use of super( ); it is illegal to 
specify the actual name of the class. For example: Sphere (double x, 
double y, double z, double radius) { Point (x, y, z); this. radius = 
radius; } is illegal. 

• Never place any subclass constructor code ahead of its superclass con- 
structor call. For example, changing the order of statements in the 
previous code fragment's Sphere constructor to this, radius = radius; 
super (X, y, z) ; results in a compiler error. That rule exists because 
a subclass constructor's initialization code might depend on the values 
of fields declared in a superclass layer. If the superclass's fields have 
not initialized, the subclass constructor would not properly initialize. 
By forcing a superclass constructor call to be specified before any 
other initialization code, the compiler prevents such logic errors from 
occurring. 

CAUTION 

The compiler does not allow superclass constructors to be called from nonconstructor 
subclass methods. Also, l<eyword super — not the actual superclass name — must be 
specified when calling a superclass constructor. Finally, the compiler doesn't allow, in a 
subclass constructor, any code to be placed ahead of a superclass constructor call. 



Overriding Methods 

Subclass methods can override (that is, replace) superclass methods. The 
subclass performs the override by declaring a method with the same name, 
same return type, and same parameter list as its superclass counterpart. 
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EXAMPLE 



The following code fragment demonstrates method overriding: 

class Point 

{ 

void draw () 
{ 

/ / Code to draw a point . 

} 

} 



class Sphere extends Point 
{ 

void draw () 
{ 

// Code to draw a sphere. 

} 

} 

Based on the code fragment, executing Sphere s = new Sphere {); s.draw 
( ) ; results in Sphere's draw( ) method being called. However, if Sphere did not 
override draw( ), Point's draw( ) method would be called. The reason is that in 
the absence of Sphere overriding draw( ), Sphere would inherit Point's draw( ) 
method. 

TIP 

When should you override and when should you inherit? You override when you want to 
add specialization to a subclass. For example, you would override a Point class's 
area() method in a Circle subclass so that a Circle's area is calculated as the 
mathematical constant PI multiplied by the square of the radius, instead of zero (which 
is a point's area). You inherit when you want to take advantage of commonality. For 
example, you would inherit an Employee class's getNameO method in an Accountant 
subclass because accountants (and other employees) have names. 




In some situations, you might find yourself with a subclass that has a 
member which is identical to a superclass member, and you might want to 
access the superclass member from a subclass. How do you accomplish that 
task? You prefix the member name with the super keyword and a period 
character. 

\ I / The following code fragment demonstrates accessing same-named super- 
class members from a subclass: 

class A 



EXAMPLE 



{ 



int field = 1 ; 



protected void method () 
{ 
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System. out. println (field); 

} 

} 

class B extends A 
{ 

int field = 2; 

protected void method () 
{ 

System. out. println (field); 
System. out. println (super.f ield) ; 
super. method (); 



} 



} 



The code fragment reveals two things. First, when overriding methods, it is 
customary to declare those methods with the protected kejrword. Second, if 
a subclass needs to access a superclass's same-named members, the sub- 
class must prefix the member name with keyword super and a period. For 
example: super. field refers to class a's field member, and super. method (); 
refers to a's method () member. 

If you would like to run the aforementioned code fragment, you will need to 
introduce a main ( ) method. The simplest way to do that is to introduce the 
mainO method into class B, as the following code fragment demonstrates: 
class B extends A 
{ 

int field = 2; 

protected void method () 
{ 

System. out. println (field); 
System. out. println (super.f ield) ; 
super. method (); 

} 

public static void main (String [] args) 
{ 

B b = new B ( ) ; 
b. method (); 

} 
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CAUTION 

A subclass cannot make a method's access level more restrictive. For example, declar- 
ing method ( ) to be private in B would cause the compiler to report an error, because 
private is more restrictive than protected. Java recognizes public as the most accessi- 
ble (and least restrictive) level. That is followed by protected, package, and private 
access levels (in a decreasing order of accessibility and an increasing order of restric- 
tiveness). 

A subclass method can override a superclass method only if the superclass 
method is both accessible and nonfinal. A method is made final by declaring 
it with the final kejnvord. For example, suppose, in the earlier code frag- 
ment, that A declares method () as final protected void method () { }. 
Attempting to compile the code fragment with the newly marked final 
method would cause the compiler to report an error when it detects b's 
method ( ) override. The rationale for declaring a method final is to prevent a 
subclass from modifying whatever rules are established in the superclass's 
method. 

CAUTION 

Just as you cannot extend a final class, you cannot override a final method. Any 
attempt to do so will cause the compiler to report an error. 




EXAMPLE 



SUBCLASS-SUPERCLASS CASTING 

A subclass object is also a superclass object. That fact is due to a subclass 
having members that correspond to each of the superclass's members. For 
example, a Sphere object is also a Point object, and an Accountant object is 
also an Employee object. The implication of a subclass object also being a 
superclass object is that a subclass object reference can be assigned to a 
superclass object reference variable. 

The following code fragment demonstrates a subclass object (such as 
Sphere) to be also a superclass object (such as Point). No cast is required 
when assigning a subclass object reference to a superclass object reference 
variable: 

Point p = new Sphere (1.0, 2.0, 3.0, 4.0); 

What does it mean to assign a subclass object reference to a superclass 
object reference variable? It means that an object is to be accessed in a 
more restricted manner. To observe that restriction visually, take a look at 
Figure 6.5, imagine that the box labeled s is labeled p, and imagine that the 
arrow points from that box to the Point layer, instead of the Sphere layer. 
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EXAMPLE 



Using p, code can freely call getx( ), getY( ), and getz( ). Those methods can 
be called because they are declared in Point. However, getRadius( ) cannot 
be called because that method is declared in Sphere. Although there is a 
getRadius( ) method in the object referenced by p, the Point class does not 
declare a getRadiusO method, and the compiler's static type-checking rules 
prohibit a call to a method that is neither declared in a class nor inherited 
from a superclass. 

When an appropriate cast is specified, however, the compiler permits a sub- 
class method to be called, via a superclass object reference variable. For 
example, assuming that the previous code fragment has just executed, the 
following code fragment recovers the radius: double radius = ((Sphere) 
p) . getRadius ( ) ; . The compiler regards that expression as being legal 
because Sphere is a subclass of Point, and the possibility exists that p will 
contain a reference to a Sphere object. 

Care must be exercised when casting from a superclass to a subclass. For 
example, if the object referenced by p is not a Sphere object, there is no 
guarantee that the object has a getRadiusO method. Although the compiler 
regards a superclass to a subclass cast as being legal, it is up to the JVM 
(at runtime) to detect whether the actual object contains the appropriate 
method. For example, if the JVM detects that there is no getRadiusO 
method with the appropriate parameter list and return type, the JVM 
throws a ClassCastException object. (If the JVM tried to call the missing 
method, the JVM software would most likely crash.) 

The CCE source code in Listing 6.2 demonstrates how easy it is to have the 
JVM throw a ClassCastException object. 

Listing 6.2 CCE.java 
// CCE.java 

class Superclass 

{ 

} 

class Subclassi extends Superclass 
{ 

void methodi () 
{ 

System. out. println ("1"); 

} 

} 



class Subclass2 extends Superclass 
{ 
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Listing 6.2 continued 
void nethod2 () 
{ 

System. out. println ("2"); 

} 

} 

class CCE 
{ 

public static void main (String [] args) 
{ 

Superclass sup = new Subclass2 (); 
((Subclassi) sup).method1 {); 

} 

} 

The Superclass sup = new Subclass2 ( ) ; assignment is legal because a 
Subclass2 object is also a Superclass object. The ( (Subclassi ) sup) cast is 
also legal because sup might contain a reference to Subclassi — the compiler 
has no way of determining whether sup contains either a Subclassi refer- 
ence or a Subclass2 reference. Therefore, the attempt to call methodi ( ) using 
sup is legal. However, because sup references a Subclass2 object, and 
because Subclass2 does not declare a methodi ( ) method, it is up to the JVM 
to detect that situation. In response, the JVM throws a ClassCastException 
object. 



✓ To learn more about throwing exceptions, see "Throwing Exceptions," p. 342. 

Why restrict member access? One reason is to eliminate redundant code 
during a common operation performed in a loop. 

The following code fragment assumes an Ellipse class that, like Sphere, is 
derived from Point. An array of "Point" objects is created, and a loop prints 
each object's (x, y, z) coordinates: 

Point [] p = { new Sphere (1.0, 2.0, 3.0, 4.0), new Ellipse () }; 

for (int x = 0; x < p. length; x++) 

System. out. println ("(" + p [x].getx () + ", " + p [x].getY () + 
", " + p [x].getz 0 + ")"); 

Another reason for the restriction has to do with poljonorphism — the third 
OOP principle. The idea behind polymorphism (from a method overriding 
perspective) is for a subclass to override a superclass method and, at run- 
time, for the subclass's method to be called from a superclass reference 
variable. Because the method being called exists in both the subclass and 




EXAMPLE 
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the superclass, there really is no restriction. The JVM ensures that the cor- 
rect subclass method is called, by using the reference stored in the super- 
class object reference variable. 

If both Point and Sphere declared a draw( ) method, the following code frag- 
ment would result in Sphere's draw( ) method being called — in a polymorphic 
fashion: 

Point p = new Sphere (1.0, 2.0, 3.0, 4.0); 
p. draw 0; 



✓ To learn more about polymorphism, see "Method Binding," p. 247. 



The Root of All Classes 



With one exception, every Java class has a superclass. The single exception 
is the root of all classes: Object. The Object class is known as Java's root 
class because all Java classes inherit from that class. In the absence of the 
keyword extends, a class inherits directly from Object. Otherwise, the class 
inherits from Object by way of one or more intermediate superclasses. And 
what does a class inherit? The class inherits Object's eleven methods. 

Object's methods are common to all classes. Some of those methods are 
declared final: They cannot be overridden because their behavior is common 
to all objects created from all classes. Other methods can be overridden — to 
adapt to each object's uniqueness. Table 6.1 describes each of Object's 
eleven methods: 

Table 6.1 Object Methods 



Method 



Description 



Object cloneO 

boolean equals(Object o) 



void finalizeO 



Class getClassO 



int hashCodeO 
void notify 0 

void notifyAllO 



Creates and returns a copy of the current object. 
Compares the current object with the object refer- 
enced by 0, to see whether they have equal con- 
tents. 

When the garbage collector determines that there 
are no more references to the current object, it calls 
finalizeO to give the object a chance to clean up. 
Each object associates with another object that's 
created from a class named class. A reference to 
that Class object returns when getClassO is called. 
Returns the current object's hash code. 
Wakes up a single thread that is waiting on the 
current object's monitor. 

Wakes up all threads that are waiting on the current 
object's monitor. 
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Table 6.1 continued 



Method 



Description 



string toStringO 
void waitO 



void wait (long millis) 



void wait(long millis, 
int nanos) 



Returns a string representation of tlie current object. 
Causes tlie current tliread to wait until anotlier 
tliread calls either of the current object's notifyO 
or notifyAllO methods. 
Causes the current thread to wait until either 
another thread calls either of the current object's 
notify 0 or notifyAii() methods, or a specified 
amount of time (measured in milliseconds) has 
elapsed. 

Causes the current thread to wait until either 
another thread calls either of the current object's 
notify 0 or notifyAll() methods, or a specified 
amount of time (measured in milliseconds and 
nanoseconds) has elapsed. That method is similar 
to the preceding method but allows for a finer 
degree of control over the wait time, and it would be 
used in a real-time program. 



NOTE 

The innermost layer of every Java object is represented by Object. That means an 



object's phmordial layer consists of eleven methods- 
declares no fields. 



-and no fields, because Object 



Class Information 

Behind the scenes, when a Java program runs, Java creates a Class object 
corresponding to each class from which one or more objects are created. 
That Class object is the object locked by static synchronized methods. 
Furthermore, Class objects are an important part of Java's Reflection API. 



NOTE 

This book does not discuss the Reflection API. To learn more about that API, visit Sun's 
Reflection API Trail in its online Java Tutorial (http://java.sun.com/docs/books/ 
tutorial/reflect/ index, html). 



Object's getClass( ) method returns a reference to the Class object associated 
with the object that calls getClass( ). Because that method is declared to be 
final, subclasses cannot override getClass( ). 

\ I / The Classinf oDemol source code in Listing 6.3 demonstrates calls to 
getClass( ), to obtain Class objects that correspond to the String and 
Classinf oDemol classes. 




EXAMPLE 
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Listing 6.3 ClassInfoDemol . java 
// ClassInfoDemol . java 

class ClassInfoDemol 
{ 

public static void main (String [] args) 
{ 

String s = ""; 

Class c = s.getClass () ; 

System. out. println (c.getName ()); 

c = new ClassInfoDemol ().getClass (); 
System. out. println (c.getName ()); 



} 



} 



After a Glass object has been obtained, any of its methods can be called. For 
example, Class's getNameO method returns the fully qualified name (which 
includes package information) of the class from which an object was cre- 
ated. 

✓ To learn more about packages, see "What Are Packages?" p. 428. 

When run, ClassInfoDemol prints the following fully qualified class names: 
java. lang. String 
ClassInfoDemol 



Because getClassO cannot be called for primitive types (such as integer and 
OUTPUT double-precision floating-point), and because it might be inconvenient to 
create an object before getClass( ) can be called, Java provides a shortcut: 
the .class suffix. When the .class suffix is appended to a type name, a 
Glass object corresponding to that type (whether it be primitive or refer- 
ence) returns. 



EXAMPLE 



\ I / The Glassinf oDemoa source code in Listing 6.4 demonstrates the use of the 
01 .class suffix. 

Listing 6.4 ClassInfoDemo2. java 
// ClassInfoDemo2. java 

class Classinf oDemo2 
{ 

public static void main (String [] args) 
{ 

Class c = String. class; 
System. out. println (c.getName ()); 
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Listing 6.4 continued 

c = ClassInfoDe[iio2. class; 

System. out. println (c.getNane ()); 

c = double. class; 

System. out. println (c.getName ()); 



// The first of the following commented -out lines causes the 
// compiler to report a "class expected" error message. 



OUTPUT 



// c = char.getClass ( ) ; 

// System. out. println (c.getName ()); 

c = float [ ] .class; 

System. out. println (c.getName ()); 

} 

} 

The .class suffix can be appended to either a reference type name or a 
primitive tj^e name. Classinf oDemo2 prints the following, when run: 

java.lang. String 
Classinf oDemo2 
double 
[F 

The first three output lines identify the String and Classinf oDemo2 classes, 
and the double-precision floating-point primitive type. However, what does 
[ F mean? That strange notation is used at the JVM level to refer to array 
types. Each open square bracket refers to an array dimension. In the exam- 
ple, the presence of a single square bracket signifies an array of one dimen- 
sion. Also, the capital letter F is the JVM's way of identifying an array of 
floating-point values. 



✓ To learn more about arrays and array dimensions, see "Fundamental Data Structures," 
p. 496. 

Take a close look at ClasslnfoDemo2, and you will discover a pair of 
commented-out lines. Those lines are present to show you that, although 
you can append .class to a primitive type keyword, a primitive type key- 
word does not represent an object. As a result, you cannot call getClass( ) — 
or any other method — via the primitive type keyword. 

Object Cloning 

In recent years, the topic of cloning has been widely discussed. However, 
sheep and pigs are not the only entities that can be cloned (duplicated): 
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Java objects can also be cloned, thanks to Object's clone ( ) method. When 
called, clone ( ) returns a reference to an object that is an exact duplicate of 
the object which called clone ( ). Because clone ( ) does not call a constructor 
method to perform initialization, clone ( ) is a bit faster than using new and a 
constructor call to create an object. 

Object declares clone () with an Object return type. That return type 
implies the object reference returned by clone ( ) must be cast to the object's 
actual type, before assigning that reference to a variable of the object's 
type. For example, to clone an object from the Sphere class, you might spec- 
ify something like Sphere s2 = (Sphere) s. clone (); (in which the code 
fragment assumes s to contain a reference to a previously created Sphere 
object). 

For your first taste of cloning. Listing 6.5 presents source code to the 
CloneDemol application. 

Listing 6.5 CloneDemol . j ava 
// CloneDemol .Java 

class CloneDemol implements Cloneable 
{ 

double salary = 50000.0; 

public static void main (String [] args) 
throws CloneNotSupportedException 

{ 

CloneDemol cd1 = new CloneDemol (); 
System. out. println (cd1 . salary) ; 

CloneDemol x = (CloneDemol) cd1. clone (); 
System. out. println (x. salary); 

AnotherClass ac = new AnotherClass (); 
System. out. println (ac.gradeLetter) ; 

// AnotherClass y = (AnotherClass) ac. clone (); 
// System. out. println (y.gradeLetter) ; 



} 



} 



class AnotherClass 
{ 

char gradeLetter = 'C ; 

} 
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CloneDemol's main() method calls cdl .clone() to duplicate the CloneDemol 
object referenced by cdl. Following the cloning operation, clone ( ) returns a 
reference to a new CloneDemol object, which assigns to x. Both objects, refer- 
enced by cd1 and x, have a salary instance field that contains 50000.0. 

When run, CloneDemol produces the following output: 

50000.0 
50000.0 
0 



OUTPUT A careful examination of Listing 6.5 raises several questions. First, what is 
throws CloneNotSupportedException doing at the end of main()'s method 
signature? Second, what is implements Cloneable doing at the end of the 
CloneDemol class declaration header? Third, why is AnotherClass y = 
(AnotherClass) ac. clone ( ) ; commented out? Finally, how does cloning 
work? Good questions. Let's find some answers! 

What is throws CloneNotSupportedException doing at the end of 
mainO's method signature? It's allowing main()'s caller to handle any 
CloneNotSupportedException objects thrown from the clone () method. 
And why would clone () throw such an exception? Sometimes, a superclass 
supports cloning, and it is desirable to prevent subclass objects from being 
cloned. The way to prevent cloning in the subclass is for the subclass to 
override the superclass's clone () method, and have the overridden clone () 
method explicitly throw a CloneNotSupportedException object to the JVM. 

The following code fragment demonstrates how to prevent cloning in a 
subclass: 

class Subclass extends Superclass 

EXAMPLE { 

protected Object clone () throws CloneNotSupportedException 
{ 

throw new CloneNotSupportedException (); 

} 

} 

Any attempt to execute Subclass so = new Subclass ( ) ; Subclass sol = 
(Subclass) sc. clone (); results in a CloneNotSupportedException object being 
thrown to the JVM. 

✓ To learn more about throwing exceptions and Throws clauses, see "Throwing 
Exceptions," p. 342. 

What is implements Cloneable doing at the end of the CloneDemol class decla- 
ration header? Cloneable is known as an interface — a concept to be dis- 
cussed later in this chapter. That interface can declare method signatures 
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and constants but is totally empty; it helps Object's clone ( ) method identify 
those subclasses that must have their field values duplicated. Object's 
clone 0 method throws a CloneNotSupportedException object if it cannot find 
a class in a class hierarchy that implements Cloneable. (That will make 
more sense after you learn how cloning works.) 

Why is AnotherClass y = (AnotherClass) ac.cloneO ; commented out? 
Unlike most of Object's methods, clone ( ) is given a protected level of access. 
That restriction means only code in those classes that are part of Object's 
package and code in subclasses of Object (regardless of package) can call 
clone (). The implication of making clone () protected is that, by default, 
objects can clone themselves but cannot clone other objects. In Listing 6.5, 
because cdl . clone () is located in the CloneDemol class's rrain() method, it 
has access to CloneDemol's inherited clone() method. However, ac.cloneO, 
which is also located in CloneDemol's main( ) method, does not have access to 
AnotherClass's inherited clone ( ) method. As a result, the compiler will not 
compile the commented-out line. That is what protected access is all about: 
Only code contained in the same class, another class in the same package, 
or any subclass (regardless of package) can access a protected member — 
like clone (). So why does Object declare clone () with a protected access 
level? For various reasons, it might not be desirable to clone an object cre- 
ated from some class. For example, the String class prevents cloning, by 
leaving clone () protected. It does that because String objects are considered 
immutable (that is, unchangeable). Being allowed to create copies of String 
objects violates that rule. 

To allow an object created from some other class to be cloned, it is neces- 
sary to override that class's clone () method. The overridden method calls 
super. clone 0 to allow Object's clone () method to perform the cloning opera- 
tion. That is demonstrated in Listing 6.6's CloneDemo2 source code. 

Listing 6.6 CloneDemo2 . j ava 
// CloneDerio2. java 

class CloneDemo2 implements Cloneable 
{ 

double salary = 50000.0; 

public static void main (String [] args) 
throws CloneNotSupportedException 

{ 

CloneDeno2 cd2 = new CloneDeno2 (); 
System. out. println (cd2. salary) ; 
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Listing 6.6 continued 

CloneDeno2 x = (CloneDemo2) cd2. clone (); 
System. out. println (x. salary); 

AnotherClass ac = new AnotherClass (); 
System. out. println (ac.gradeLetter) ; 

AnotherClass y = (AnotherClass) ac. clone (); 
System. out. println (y .gradeLetter) ; 



} 



} 



class AnotherClass implements Cloneable 
{ 

char gradeLetter = 'C ; 

public Object clone () throws CloneNotSupportedException 
{ 

return super. clone () ; 

} 

} 

How does cloning work? To understand cloning, first realize that cloning 
involves making copies of fields; it does not make copies of methods. 
Second, you should know that there are two forms of cloning: shallow 
cloning (also known as shallow copjdng) and deep cloning (also known as 
deep copying). All the cloning examples that have thus far been presented 
use shallow cloning. 

Shallow cloning involves duplicating the contents of fields. If one of those 
fields is a reference field, the reference is copied into the clone. That means 
an object and its clone can reference the same object. 

Suppose you have a class hierarchy and are going to clone an object (using 
shallow cloning) from the lowest class in the hierarchy. Furthermore, sup- 
pose none of those classes overrides clone( ). Therefore, the lowest class will 
directly call Object's clone () method. To call clone (), a class must imple- 
ment Cloneable. However, do all the hierarchy's classes need to implement 
Cloneable or just one class? For an answer, check out the source code to the 
CloneDemoS application in Listing 6.7. 

Listing 6.7 CloneDemoS . j ava 
// CloneDemoS. Java 



class A // implements Cloneable 
{ 
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Listing 6.7 continued 
int 1 = 1; 

} 

class B extends A implements Cloneable 
{ 

int m = 2; 

} 

class CloneDemo3 extends B // implements Cloneable 
{ 

int n =3; 
A a = new A ( ) ; 

public static void main (String [] args) 
throws CloneNotSupportedException 

{ 

CloneDemo3 c = new CloneDemo3 (); 
CloneDemo3 c2 = (CloneDemo3) c. clone (); 

System. out. println (c.l) 

System. out. println (c2.1 

System. out. println (cm) 

System. out. println (c2.m 

System. out. println (c.n) 

System. out. println (c2.n); 

System. out. println (c.a == c2.a); 

} 

} 

It doesn't matter which class implements Cloneable, or whether all the 
classes implement Cloneable. As far as Object's clone () method is concerned, 
at least one class in the hierarchy must implement Cloneable. When run, 
CloneDemoS produces the following output: 

1 
1 
2 
2 
3 
3 

true 

The last output line proves that CloneDemoS's c. clone ( ) method call uses 
shallow cloning. The a reference field in each object references the same 
object. That is why c. a == c2. a returns true. 
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Shallow cloning is not always desirable. For example, when objects are 
stored in a data structure object, and the data structure object is cloned, 
shouldn't each data structure object have its own copy of each stored object? 
To get around that limitation, Java allows you to perform deep cloning. 
Deep cloning ensures that objects are duplicated — not just their references. 

The CloneDemo4 source code in Listing 6.8 is similar to the CloneDemo3 source 
code in Listing 6.7. The biggest difference is that CloneDemo4 overrides 
clone 0, to provide deep cloning. 

Listing 6.8 CloneDemo4 . j ava 
// CloneDemo4. Java 

class A // implements Cloneable 
{ 

int 1 = 1; 

} 

class B extends A implements Cloneable 
{ 

int m = 2; 

} 

class CloneDemo4 extends B // implements Cloneable 
{ 

int n =3; 

A a = new A ( ) ; 

public static void main (String [] args) 
throws CloneNotSupportedException 



{ 



CloneDemo4 c = new CloneDemo4 (); 
CloneDemo4 c2 = (CloneDemo4) c. clone () 

System. out. println (c.l); 

System. out. println (c2.1); 

System. out. println (cm); 

System. out. println (c2.m); 

System. out. println (c.n); 

System. out. println (c2.n); 



System. out. println (c.a c2.a); 

} 
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Listing 6.8 continued 

protected Object clone () throws CloneNotSupportedException 
{ 

// First, perform a shallow copy. 

CloneDeno4 temp = (CloneDeno4) super. clone (); 

// Only clone a if there is a reference. This will always 
// be the case for this program. The only reason for the 
// if is to demonstrate safety. 

if (a != null) 

temp. a = new A ( ) ; 



return temp; 



} 

} 



Deep cloning works by overriding the clone ( ) method. The first task per- 
formed by that overridden method is a shallow copy. Each field's value is 
duplicated in the clone. After that task finishes, each of the clone's refer- 
ence fields must assign to a duplicate of the object that's referenced by the 
current object's corresponding reference field. If you run CloneDemo4, you 
will see false as the last line of output. That proves the CloneDe[no4 objects 
referenced by c and c2 are referencing two different A objects through their 
a object reference variables. 

In CloneDemo4's clone ( ) method, it didn't matter that the object referenced 
by a was duplicated via temp . a = new A ( ) ; . It didn't matter because class A 
contains no other reference fields. However, that is not always the case. To 
properly deep clone an object (such as a CloneDemQ4 object), it is better to 
recursively call the clone ( ) method (as in temp .a = (A) a . clone () ; ). The 
CloneDemoS source code in Listing 6.9 demonstrates. 

Listing 6.9 CloneDemoS . j ava 
// CloneDemoS. Java 

class A implements Cloneable 
{ 

String s = "abc"; 



protected Object clone () throws CloneNotSupportedException 
{ 

// Perform a shallow copy. 
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Listing 6.9 continued 

A temp = (A) super. clone {); 

if (s != null) 

tenp.s = new String ("abc"); 

return temp; 

} 

} 

class CloneDenoS implements Cloneable 
{ 

int X = 3; 

A a = new A ( ) ; 

public static void main (String [] args) 
throws CloneNotSupportedException 

{ 

CloneDemoS c = new CloneDemoS (); 
CloneDemoS c2 = (CloneDemoS) c. clone (); 

System. out. println (c.x); 
System. out. println (c2.x); 

System. out. println (c.a == c2.a); 
System. out. println (c.a.s c2.a.s); 

} 

protected Object clone () throws CloneNotSupportedException 
{ 

// Perform a shallow copy. 

CloneDemoS temp = (CloneDemoS) super. clone (); 



if (a != null) 

temp. a = (A) a. clone () ; 



return temp; 



OUTPUT 



} 

When run, CloneDemoS produces the following output: 

3 
3 

false 
false 
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In CloneDemoS, class A must be capable of cloning itself because it contains a 
String reference field — s. Unlike a.clone(), it is not possible to write temp.s 
= s . clone ( ) ; , because the String class does not support cloning. That is the 
only situation in which it is okay to create an object from a class, instead of 
calling clone ( ) to clone the object. 

With all the various concepts you must keep in mind about cloning objects, 
you might be apprehensive at the thought of cloning arrays. However, 
cloning arrays is simpler than cloning objects. For proof, examine the 
CloneDemoS source code in Listing 6.10. 

Listing 6.10 CloneDemoe. Java 
// CloneDeno6. Java 

class CloneDeno6 
{ 

public static void main (String [] args) 
{ 

String [] countries = 
{ 

"China" , 
"Saudi Arabia" , 
"Germany" 

}; 

string [] countries2 = (String []) countries. clone (); 

for (int i = 0; i < countries2. length; i++) 
System. out. println (countries2 [i]); 

System. out. println ( " \ncountries == countries2: " 

+ (countries == countries2) + "\n"); 

System. out. println ("countries [0] == countries2 [0]: " 

+ (countries [0] == countries2 [0]) + "\n"); 

char [] gradeLetters = 
{ 

'A', 'B', 'C, 'D', 'E', 'F' 

}; 

char [] gradeLetters2 = (char []) gradeLetters. clone (); 




EXAMPLE 



} 

} 



for (int i = 0; i < gradeLetters2. length; i++) 
System. out. println (gradeLetters2 [i]); 
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OUTPUT 



When it comes to cloning arrays, there is no CloneNotSupportedException 
Throws clause to deal with; there is no Cloneable interface to think about; 
and so forth. CloneDertio6, when run, prints the following: 
China 

Saudi Arabia 
Germany 

countries == countries2: false 

countries [0] countries2 [0]: true 

A 
B 
C 
D 
E 
F 

A careful study of the CloneDemoe source code shows array cloning uses 
shallow copying instead of deep copying. That is why countries [0] and 
countries2 [0] refer to the same String object. 

Object Equality 

Equality operators and ! = determine whether the contents of two vari- 
ables are equal or not equal. A Boolean true value returns to indicate equal- 
ity (with ==) or inequality (with !=). Otherwise, a Boolean false value 
returns. When comparing the contents of two variables of the same primi- 
tive type (such as Boolean), equality/inequality comparisons using those 
operators are straightforward. However, many developers make the mis- 
take of thinking that == and ! = can be used to determine whether two 
objects are equal or not equal. 

To see the folly of using to determine whether two objects are the same, 
consider the following code fragment: 
Company c1 = new Company ("Sun Microsystems"); 
EXAMPLE Company c2 = new Company ("Sun Microsystems"); 
Company c3 = new Company ("Microsoft"); 

System. out. println ("c1 == c2: " + (c1 == c2)); 
System. out. println ("c1 == c3: " + (c1 == c3)); 

When the code fragment runs, you might expect to see the following output: 

c1 == c2: true 
c1 == c3: false 
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However, you will see the following output, instead: 

c1 == c2: false 
c1 == c3: false 



The objects referenced by ci and c2 refer to different objects — even though 
OUTPUT those objects contain the same "Sun Microsystems" contents. When you com- 
pare two variables of the same reference type (such as ci and c2) with an 
equality operator (such as ==), you are comparing the references stored in 
those variables; you are not comparing the contents of the objects. The pre- 
viously mentioned code fragment creates three separate Company objects, 
and each object has its own distinct reference. As a result, returns false 
when comparisons are made. If you want to compare two objects, you must 
use Object's equals () method. 

Object's equals ( ) method takes a single Object argument and compares that 
argument's reference, using ==, with the current object reference. When it 
comes to comparing objects, that is no better than using == directly. To 
properly compare objects, equals ( ) must be overridden. The overridden 
equals () method should then return a Boolean true value if the object refer- 
enced by its argument contains the same contents as the current object. 
Otherwise, equals () should return false. 

The EqualityDemo source code in Listing 6.11 demonstrates overriding 
equals 0 to determine whether three Company objects are equal. 

Listing 6.11 EqualityDemo . j ava 
// EqualityDemo. Java 

class Company 
{ 

private String name; 

Company (String name) 
{ 

this. name = name; 

} 

public boolean equals (Object o) 
{ 

if (!(o instanceof Company)) 
return false; 



EXAMPLE 



Company c = (Company) o; 
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Listing 6.11 continued 

return name. equals (c.name); 

} 

} 

class EqualityDeno 
{ 

public static void main (String [] args) 
{ 

Company c1 = new Company ("Sun Microsystems"); 
Company c2 = new Company ("Sun Microsystems"); 
Company c3 = new Company ("Microsoft"); 

System. out. println ("c1. equals (c2): " + c1. equals (c2)); 
System. out. println ("c1. equals (c3): " + c1. equals (c3)); 

} 

} 

The Company class overrides equals () to determine whether two Company 
objects are equal. The first thing equals ( ) does is determine whether its 
Object argument is an instance of the Company class. If not, false returns. 
The reason for that test is to deal with situations in which an attempt is 
made to compare a Company object with a non-Company object — like an 
EqualityDemo or a String object. In either situation, the comparison would be 
meaningless. Following the test, o is cast from Object to its actual Company 
type. That is done so that o's name field can be accessed. Then, equals ( ) is 
used to determine whether the name fields in both Company objects are equal. 

When you run EqualityDemo, you'll see the following output, which shows 
that the Company objects referenced by cl and c2 are equal: 

c1. equals (c2): true 
c1 .equals (c3) : false 

Keep the following five items in mind when overriding equals (): 

• The equals ( ) method should obey the law of reflexivity. That law 
states for any x, x. equals (x) should return true. 

• The equals ( ) method should obey the law of symmetry. That law 
states for any x and y, x. equals (y) should return true if and only if 
y.equals(x) returns true. 




• The equals ( ) method should obey the law of transitivity. That law 
states for any x, y, and z, if x.equals(y) returns true and y.equals(z) 
returns true, x. equals (z) should also return true. 
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• The equals ( ) method should consistently return either true or false, 
as long as the contents of the objects being compared have not 
changed. 

• For any non-null reference x, x. equals (null) should return false. 

Finalization 

Objects are created and destroyed when they are no longer needed. 
Although the developer has control over an object's creation, it is the JVM's 
garbage collector that ultimately destroys an object. The only thing a devel- 
oper can do in regard to encouraging the garbage collector to destroy an 
object is to assign null to all of that object's reference variables. The 
garbage collector destroys an object only when there are no references to 
the object. 

Before the garbage collector destroys an object, it calls that object's 
finalize ( ) method, to give the object a chance to perform cleanup tasks. 
That activity is known as finalization. 

✓ To learn more about finalization, see "Finalization," p. 311. 

NOTE 

Like cloneO, the finalize () method is declared with a protected access level. That 
is done to prevent program code from calling finalize(). For example, if the compiler 
encounters String name = "Sun Microsystems"; name. finalize (); in source 
code, it reports an error stating that finalize ( ) has protected access. After all, it is 
the garbage collector's job to call finalizeO, and attempts to call that method from 
program code could cause problems due to prematurely executing finalize {)'s 
cleanup code. 



Hash Codes 

When Java made its public debut in 1995, Hashtable was one of the classes 
included in its class library. That data structure class is used to efficiently 
store and retrieve objects using the object's key (that is, something unique 
about the object that uniquely distinguishes it from another object) to index 
into that structure. To help accomplish its task, Hashtable enlists the 
services of Object's hashCodeO method. 

The hashCode( ) method returns an integer that represents a hash code. 
What is a hash code? It is some integer number that uniquely identifies an 
object. The Hashtable class, when handed an object to be stored in a hash 
table, calls that object's hashCode( ) method. The return value aids the hash 
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table in storing the object so that the hash table can efficiently retrieve 
that object, when asked to do so (by code that stores the object in the hash 
table). 

✓ To learn more about hash codes, keys, and Hashtable, see "Fundamental Data 
Structures," p. 496. 

Subclasses can override hashCode( ). However, when overriding that method, 
keep the following general contract in mind: 

• Whenever code invokes hashCode( ) on a given object during the execu- 
tion of a Java program, hashCode ( ) must consistently return the same 
integer, provided no object information used by the equals ( ) method, 
to compare that object with another object, changes. However, the 
integer that hashCode () returns can differ across multiple executions of 
the Java program. 

• If equals ( ) determines that two objects are equal, each object's 
hashCode ( ) method must return the same integer. 

• If equals ( ) determines that two objects are unequal, it is okay for each 
object's hashCode 0 method to return the same integer. However, in 
that situation, producing different integers might improve the perfor- 
mance of a hash table. 



NOTE 

Some JVMs might implement hashCode ( ) to return the actual memory address of an 
object, because memory addresses are a convenient way of expressing uniqueness. 
Having access to that address does not violate Java's security, because there is noth- 
ing Java code can do with the address. 



Notification and Waiting 

Table 6.1, shown earlier in the chapter, presents several notification and 
waiting methods. Those methods are used by threads to aid in synchroniz- 
ing access to shared variables. The notification methods are called by a 
thread to wake up one or more of several waiting threads. In contrast, the 
waiting methods cause a thread to either wait indefinitely until notified by 
another thread or wait for a specific period if not notified before the time 
expires. Because the notification and waiting methods are declared to be 
final, subclasses cannot override those methods. 



✓ To learn more about the notification and waiting methods, see "Synchronization," p. 389, 
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String Representation 

The final Object method to be explored, toString{), returns a representation 
of the current object, as a String object. Unless toString( ) is overridden, it 
returns a String that consists of the current object's class name followed by 
an & character followed by a hash code (in hexadecimal format). It does so 
by executing the following code fragment: 

return getClass O.getName () + + Integer. toHexString (hashCode ()); 

The default toString( ) method identifies an object's class and hash code. 
That is demonstrated by the StringRepDemol source code in Listing 6.12. 

Listing 6.12 StringRepDemol . Java 
// StringRepDemol . java 

class StringRepDemol 
{ 

public static void main (String [] args) 
{ 

StringRepDemol srd = new StringRepDemol (); 
System. out. println (srd.toString ()); 

} 

} 

When you run StringRepDemol , you will see something that looks like 
StringRepDemol ®2a340e. (Of course, you might not see 2a340e, because each 
object has its own hash code.) 

Why override toString( )? One reason is debugging. Suppose you override 
toString( ) in each of your program's classes. Each class's overridden 
toString( ) method prints the contents of an object's instance fields. At run- 
time, if your program is malfunctioning and you are not sure what is caus- 
ing the problem, calls to each object's toString( ) method can help you 
narrow down the problem, by displaying the current state of the object. 

The StringRepDemo2 application source code in Listing 6.13 demonstrates 
overriding toStringO to provide useful debugging information. 

Listing 6.13 StringRepDemo2. java 

// StringRepDemo2. java 

class StringRepDemo2 
{ 

int instanceField = 1 ; 



public static void main (String [] args) 
{ 
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OUTPUT 



Listing 6.13 continued 

StringRepDe[iio2 srd = new StringRepDemo2 (); 
System. out. println (srd .toString ()); 

} 

public String toString () 
{ 

return getClass () + ": instanceField = " + 1; 

} 

} 

When run, StringRepDemo2 produces the following output: 
class StringRepDemo2: instanceField = 1 

TIP 

You can see whether your object's Strings have leading or trailing spaces by including 
square bracket characters in the String returned from toString(). For example, 
assuming that a class declares a name field of type String, specify return "name = 
[" + name + "]"; in the toString ( ) method. 



Interfaces 



What comes to mind when you are confronted by the word interface? 
Perhaps you see an image of a place where two independent systems meet 
for communication. For example, a human being and a computer communi- 
cate through a keyboard, a mouse, and/or some other input device. The 
input device serves as an interface between the computer and the human 
being. From a software perspective, an interface represents a service con- 
tract between a library that implements various services and code that 
calls upon that library's services. For example, a Java program obtains file 
I/O (input/output) services by creating objects from various file-related 
classes in Java's standard class library and by calling their methods. Those 
classes and methods form an interface between code wanting file I/O and 
the actual file I/O code. 

It is possible to take the concept of interface one step further: From Java's 
perspective, an interface is a language feature that introduces (but does not 
implement) a type at the source code level. To understand that concept, 
remember that a type represents an abstraction identifying a set of data 
items — that share some commonality — and a set of operations that manipu- 
late those data items. For example, the integer type identifies a set of num- 
bers that do not have fractional parts and a set of operations that 
manipulate those numbers (such as addition and subtraction). To support 
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types, a computer language provides a facility that allows a developer to 
introduce (and possibly implement) a type in source code. 

Developers introduce primitive types into source code through keywords 
(such as double or char) and operators (such as * or /). Primitive types have 
no implementation at the source code level: The compiler and the JVM pro- 
vide an implementation. Developers introduce reference types into source 
code through class declarations (via the class keyword) and interface decla- 
rations (via the interface keyword). Classes implement reference types (at 
the source code level) by declaring read/write field variables — to identify a 
set of data items — and method signatures with code bodies — to identify a 
set of operations. Unlike classes, interfaces do not implement reference 
types in source code. Instead, an interface represents a reference type in 
source code, as a combination of constants and method signatures. 

There is a good reason why interfaces do not implement reference types in 
source code: flexibility. Consider a drawable reference type. You can use 
that reference type to indicate a wish to draw a line, a circle, a polygon, a 
triangle, a square, a rectangle, and so forth. If you implement that refer- 
ence type as a class, you assign an implementation to the reference type. 
Once done, you can use that reference type only in the context of its imple- 
mentation. In other words, you lose the flexibility of the drawable reference 
type to represent any kind of shape drawing when you implement that type 
as a class. To preserve the generality of the drawable reference type, you 
need to use an interface. 

An interface can be thought of as a contract. That contract is satisfied when 
the interface's user and implementer agree to the terms of the contract. 
Interfaces make it possible to focus on behavior without being concerned 
about implementation details. 



NOTE 

Do not confuse Java's interface language feature with the general concept of an inter- 
face. From a general perspective, every class has an interface — those members that 
are accessible to other classes constitute that interface. However, the interface speci- 
fied by those members is specific to an implementation. In contrast, Java's interface 
language feature is a source-code construct that, like a class, defines a type. That use 
of interface decouples a type from any kind of implementation. 



Declaring an Interface 

Interfaces are declared using a syntax that is similar to a class declara- 
tion's syntax: 

[ 'public' ] [ 'abstract' ] 'interface' interfaceldentifier 
'{' 
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EXAMPLE 



// constants and method signature declarations 

'}' 

An interface declaration begins with a header, minimally consisting of key- 
word interface followed by interfaceldentifier — an identifier that names 
the interface (and cannot be a reserved word). As with class names, inter- 
face names form the nouns of a Java program. 

TIP 

By convention, the first letter of an interface name is capitalized. 

You can precede keyword interface with keyword public and/or keyword 
abstract. Specify public to make interfaceldentifier visible to all classes 
and interfaces in all packages. (By default, interfaceldentifier is visible 
only to classes and interfaces in its package.) Specify abstract to highlight 
the fact that all interface method signatures are abstract — they do not have 
implementation. Because an interface is implicitly abstract, it is redundant 
to specify abstract as part of the interface's declaration. 

NOTE 

Although not shown in either the preceding chapter's class declaration syntax or this 
chapter's interface declaration syntax, certain other keywords can appear (in certain 
combinations) before either the class or the interface keyword. Those keywords 
include protected or private (to limit access to nested classes or interfaces) and 
strictf p (to specify strict floating-point arithmetic). 

A brace-delimited block follows the declaration header. Use that block to 
present an interface's members: constants and method signatures. 

Listing 6.14's Drawable interface represents the aforementioned drawable 
reference type in source code as a combination of constants and a method 
signature. 

Listing 6.14 Drawable . j ava 
interface Drawable 
{ 

int SOLID_LINES = 0; 
int DASHED_LINES = 1 ; 
int DOTTED_LINES = 2; 

int NO_FILL = 0; 
int SOLID_FILL = 1; 
int HATCHED_FILL = 2; 



void draw (int lineStyle, int fillStyle); 

} 
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The Drawable interface introduces a type called Drawable. That type specifies 
what must be done (perform some drawing) but not how to implement what 
must be done. Furthermore, it declares several constants (solid lines 
through hatched fill) and a single drawing operation (the draw( ) method). 
Although SOLID LINES, DASHED LINES, and SO on do not appear to be constants 
(because the final keyword is not specified), they are constants. Behind the 
scenes, an interface implicitly treats each of its variable declarations as 
public, static, and final. Also, an interface treats each method signature 
declaration as public and abstract. 



CAUTION 

You cannot specify either tine private or tlie protected keyword as part of an inter- 
face method signature. Attempting to do so causes the compiler to report an error. 
There is no point in specifying private because an interface's methods are visible to 
each class that implements the interface. Also, there is no point in specifying 
protected because interfaces are used outside of a class hierarchy. 



Tagging Interfaces 

When you study the Java API, you'll encounter interfaces that are empty: 
No constants or method signatures are declared in those interfaces. Two 
examples that come to mind are Cloneable (which you encountered earlier 
in this chapter) and Serializable (which you will encounter in a future 
chapter). Those tagging interfaces exist to notify various APIs that certain 
operations can be performed on objects whose classes implement the tag- 
ging interface. For example, a class implements Cloneable to tell Object's 
clone 0 method that the class's objects can be cloned. Similarly, a class 
implements Serializable to tell the Serializable API that the contents of the 
class's objects can be saved and restored. The term tagging interface arises 
because the interface tags (or identifies) a class for a specific operation. 

Implementing an Interface 

As with classes, interfaces accomplish nothing until they are used. To use a 
class, you create an object. To use an interface, you implement that inter- 
face in a class. Implementation manifests itself via an Implements clause, 
as indicated by the following syntax: 

class classldentifier [ 'extends' superclassldentifier ] 

[ 'implements' interfaceldentifier ... ] 

An Implements clause consists of the implements keyword followed by a 
comma-delimited list of interface identifiers. The class inherits constants 
and method signatures from the interface, which is known as interface 
inheritance. It is then the class's responsibility to implement the interface's 
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EXAMPLE 



methods, by providing a code body for each method. Because you can spec- 
ify one or more interface identifiers after implements, Java supports single 
interface inheritance and multiple interface inheritance. 

CAUTION 

If a class does not implement all methods In an Interface, the class is known as an 
abstract class and must be declared with the abstract keyword. Not declaring the 
class abstract causes the compiler to report an error. 

The following code fragment declares and implements an OpenClose inter- 
face: 

interface OpenClose 
{ 

void open ( ) ; 
void close ( ) ; 

} 

class Door implements OpenClose 
{ 

private Color color; 



Door (Color color) 
this. color = color; 

Color getColor () 
return color; 

public void open () 

System. out. println ("Turn door handle and pull"); 

public void close () 

System. out. println ("Turn door handle and push"); 



} 



The OpenClose interface specifies two operations, expressed as methods 
open ( ) and close ( ) . The open ( ) method signifies that it is capable of opening 
anything. Similarly, close ( ) signifies its capability to close whatever was 
opened. What is being opened and closed? OpenClose can be used to open or 
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close a door, a file, a savings account, a meeting, and so on. It is up to a 
class that implements the OpenClose interface to decide what will be opened 
and closed. To leave the realm of abstractness and have OpenClose perform 
some useful work, we implement OpenClose's methods in a Door class. That 
task is accomplished by attaching an Implements clause, consisting of key- 
word implements followed by interface name OpenClose, to Door's header, and 
by providing implementation code for OpenClose's methods. 

When a class implements an interface, you can create an object from that 
class and assign the object's reference to a variable of either the class type 
or the interface type. 

The following code fragment assumes that the preceding code fragment cre- 
ates a Door object and assigns that object's reference to both a Door object 
reference variable and an OpenClose object reference variable: 

EXAMPLE Door d = new Door (Color. red); // Assume a Color class with a red constant. 
OpenClose oc = d; 

A lot of developers become confused at this point. How can an object refer- 
ence be assigned to an interface object reference variable? The secret: If a 
class implements an interface, all objects created from that class are imple- 
mentations of the class and interface types. By using the class object refer- 
ence variable (such as d), nonprivate members of a class can be accessed. In 
contrast, by using the interface object reference variable (such as oc), only 
those methods whose signatures are declared in the interface and are 
implemented in the class can be called. (Interface constants can also be 
accessed.) For example, using d, getColor( ) can be called, in addition to 
open ( ) and close ( ) . However, using oc, only open ( ) and close ( ) can be 
called, because they are the only operations specified by the OpenClose type. 

To realize the power of interfaces, we need another class that implements 
the OpenClose interface. The following File class does just that: 
class File implements OpenClose 

EXAMPLE { 

private String name; 

File (String name) 
{ 

this. name = name; 

} 

String getName () 
{ 

return name; 

} 
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public void open () 
{ 

System. out. println ("Open the file"); 

} 

public void close () 
{ 

System. out. println ("Close the file"); 

} 

} 

Let's assume you create a File object by specifying File f = new File 
( "test . dat " ) ; . Also, let's assume that the previous Door object, referenced by 
d (and the OpenClose object reference variable oc) exists. You can either 
assign d to oc (as shown previously) or assign f to oc (as in oc = f ;). 
Executing oc. open ( ) ; opens either the file or the door, depending on the ref- 
erence assigned to oc. When using the OpenClose interface, you are thinking 
in terms of an OpenClose type: It is possible to open or close something. You 
are not thinking in terms of the actual type: Door or File. The Door class is 
part of one class hierarchy, and the File class is part of another class hier- 
archy. OpenClose is apart from either hierarchy, which is where the power of 
interfaces lies. 

Implementing Multiple Interfaces 

A class can implement multiple interfaces. Multiple interface inheritance is 
acceptable because implementation is not being inherited — only constants 
and method signatures that identify behaviors, without identifying how 
those behaviors are implemented. 

The following code fragment demonstrates multiple interface inheritance: 

interface A 
{ 

void methodA ( ) ; 

} 

interface B 
{ 

void methods ( ) ; 

} 

class C implements A, B 
{ 

public void methodA () 

{ 

} 
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public void nethodB () 

{ 

} 

} 

Class C implements interfaces A and B. That means C must provide code 
bodies for methodA() and methodB(). Clean and simple — or is it? 
Unfortunately, multiple interface inheritance isn't without its problems. 
When inheriting from different interfaces, it is possible for collisions to 
occur. Those collisions are due to same-named constants with different 
types and/or initial values or same-named methods with different return 
types. 

The following code fragment demonstrates two kinds of collisions: 

interface First 
{ 

int X = 1 ; 

public int method ( ) ; 

} 

interface Second 
{ 

double X = 2; 

public void method ( ) ; 

} 

When a class implements First and Second, the first collision arises from 
the presence of two constants named x with different types and initial val- 
ues. That collision can easily be resolved, in a class, by prefixing the con- 
stant with the name of the interface. For example, when referring to those 
constants, use First. x or Second. x. However, the second collision is more 
insidious. It arises from two methods that are identical except for return 
types. When those methods are implemented, you are faced with a situation 
in which the methods have been incorrectly overridden. Remember, you can 
override only methods that have different parameter lists. Different return 
types are not enough to distinguish one method from another when the 
compiler is trying to resolve a method call. How do you solve that problem? 
There is no easy solution. However, if you exercise caution during your pro- 
gram's design process, it is rare that you will run into that problem. 



Extending Interfaces 

Just as classes can extend other classes, interfaces can extend other inter- 
faces (but not classes). Interface extension permits type specialization 
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through additional method signatures. To extend an interface, append the 
following syntax to an interface declaration header: 
'extends' interfaceldentifierl [ ',' interfaceldentifier2 ... ] 

The syntax begins with keyword extends and continues with a comma- 
delimited list of identifiers that name interfaces. The following code frag- 
ment demonstrates interface extension: 
interface DrawableAndFillable extends Drawable 
{ 

void fill (int fillColor) ; 

} 

The DrawableAndFillable interface extends Drawable by specifying a fill 
operation — method void fill(int fillColor). 

An interface that extends another interface is known as a subinterface. 
Also, the interface from which other interfaces extend is known as a super- 
interface. 



TIP 

This chapter emphasizes the practical side of using interfaces. Because it is also 
important to gain a good theoretical grounding, you are encouraged to read the 
JavaWorld articles Thanks Type and Gentle Class (http: / /www. javaworld .com/ 
iavaworld/iw-01 -2001 / jw-01 19-type_p . html), to see why the concepts of type, 
class, and interface are not interchangeable, and A Primordial Interface? 
(http : / / www. i avaworld . com / j avaworld / jw-03 -2001 / iw-0309-primordial_p . html), 
to see why interfaces do not require an ultimate superinterface. 



Inheritance Versus Composition 



Inheritance promotes the idea of layered objects. You peel back each layer 
(which represents a class) to expose an inner layer — that class's superclass. 
At the heart of the object is a primordial layer, represented by the Object 
class. When we talk about inheritance, we are focusing on "is a" relation- 
ships. For example, we say that a sports car is a kind of car. 

The following code fragment relates Car and Sportscar classes so that 
resulting objects will be layered: 

class Car 

{ 

} 




EXAMPLE 



class Sportscar extends Car 

{ 

} 
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If you create a Sportscar object, you end up with a three-layer object: the 
Sportscar outer layer, the Car middle layer, and the innermost Object layer. 
Figure 6.6 illustrates. 




Figure 6.6: A Sportscar object consists of three layers: Sportscar, Car, and 
Object. 




EXAMPLE 



Inheritance is one side of a two-sided object-design coin. The other side is 
composition (also known as aggregation). Composition promotes the idea of 
composing an object's layers from other objects. For example, in a Sportscar 
object, the Car layer might be composed of an Engine, a Transmission, a 
SteeringMechanism, and so on. When we talk about composition, we are 
focusing on "has a" relationships. For example, we say that a car has an 
engine, has a transmission, and has a steering mechanism. 

The following code fragment composes the Car layer from Engine, 
Transmission, and SteeringMechanism: 
class Engine 



class Transmission 



class SteeringMechanism 



class Car 
{ 

private Engine e; 
private Transmission t; 
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private SteeringMechanism s; 

} 

class Sportscar extends Car 

{ 

} 

Assuming appropriate constructors for initialization, the creation of a 
Sportscar object results in a three-layer object, in which the Car layer is 
composed of Engine, Transmission, and SteeringMechanism objects (see 
Figure 6.7). 




Figure 6.7: A multilayered Sportscar object uses composition to better orga- 
nize its internal structure. 



TIP 

When should you use inheritance and when should you use composition? As a rule of 
thumb, if you find yourself Introducing redundant code In a subclass, your class hierar- 
chy Is using composition when It should be using Inheritance. For example, a circle 
does not have a point: It Is a point with radius. If you used composition to relate a 
Circle to a Point, you would end up creating a private Point field and duplicating 
Point's methods (such as getX() and getY()) In Circle. That redundancy suggests a 
problem: Composition Is being used when Inheritance Is more appropriate. 
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What's Next? 



Inheritance makes possible layered objects. It also serves as the basis for 
polymorphism, the third major OOP principle. The next chapter explores 
that principle and the related abstract classes, runtime type information, 
and dynamic methods versus switch logic concepts. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 

NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 



Reviewing It 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. What is the purpose of declaring a method final? 

2. What does the super keyword accomplish? 

3. By default, what does the Object's equals ( ) method accomplish? 

4. Why does the compiler report an error when you declare a constructor 
with at least one parameter in a superclass and do not explicitly call 
the superclass constructor from the subclass constructor? 

5. Why should you not use cloning to create new objects? 

6. In the CloneDeino2 application in Listing 6.6, you can change 
AnotherClass's clone () method declaration by substituting the 
protected keyword for public. Considering the fact that code cannot 
call another class's default protected clone () method, why is that 
legal? 

7. Why is multiple implementation inheritance a bad idea and multiple 
interface inheritance a good idea? 




REVIEW 



08 71710_CH06 11/21/01 12:14 PM Page 238 




238 Chapter 6: Inheritance 



Checking It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. Which kind of inheritance does Java not support? 

a. Multiple implementation inheritance 

b. Multiple interface inheritance 

c. Single implementation inheritance 

d. Single interface inheritance 

2. Which keyword is used by both classes and interfaces to derive capa- 
bilities from other classes and interfaces, respectively? 

a. super 

b. extends 

c. this 

d. implements 

3. Which of the following statements is false? 

a. A superclass constructor can be called only from a subclass con- 
structor. 

b. A superclass constructor is called by using super () . 

c. No code can be placed ahead of a superclass constructor call in a 
subclass constructor. 

d. Java requires a superclass constructor call to always be explicitly 
specified in a subclass constructor. 

4. An interface's method signatures default to what access level? 

a. Private 

b. Package 
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c. Public 

d. Protected 

5. Which of the following Object methods cannot be overridden? 

a. toStningO 

b. getClassO 

c. clone 0 

d. finalize () 

6. Which of the following statements is true? 

a. To access a same-named superclass field from a subclass, you 
must prefix the field's name with this and a period character. 

b. Ob j ect's clone ( ) method requires only one of a hierarchy's meth- 
ods to implement Cloneable. 

c. You cannot create objects from Object. 

d. Object's clone ( ) method defaults to performing deep copies. 

7. Which of the following interfaces is a tagged interface? 

a. Cloneable 

b. UlResounce 

c. a only 

d. a and b 

8. Which of the following Object methods has a protected access level? 



a. 


notif y ( ) 


b. 


wait ( ) 


c. 


finalize ( ) 


d. 


getClass( ) 


The 


. class suffix can be appended to what? 


a. 


Any tj^e name 


b. 


Reference types only 


c. 


Primitive tj^es only 


d. 


The null keyword 
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10. Which of the following is used to create layered objects? 

a. Composition 

b. Encapsulation 

c. Inheritance 

d. Polymorphism 

True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. Inheritance promotes "has a" relationships, and composition promotes 
"is a" relationships. 

True/False 

2. Java supports single inheritance (only) by using interface inheritance. 
True/False 

3. It is illegal to place subclass constructor code before an explicit call to 
a superclass constructor. 

True/False 

4. An overridden method's access level can be made more restrictive. 
True/False 

5. The JVM throws a ClassCastException object when a superclass refer- 
ence variable is cast to a subclass type and an attempt is made to call 
a subclass method that is not actually present. 

True/False 

6. Class Object declares eleven methods. 
True/False 

7. Every Java object is associated with a Class object. 
True/False 

8. The default toString( ) implementation returns only the name of a 
class. 

True/False 
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9. An interface can directly extend two or more superinterfaces. 
True/False 

10. A class can implement only a single interface. 
True/False 



APPLY 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. What is wrong with the following Errors application source code? 
// Errors. java 

interface A 
{ 

double PI = 3.1415; 



void method {); 



} 



interface B 
{ 

double PI = 3.14159; 



void method {); 



} 



class C implements A, B, A 

{ 

} 

class Errors implements C 
{ 

public static void main (String [] args) 



{ 



} 



System. out. println (PI); 



void method () 
{ 

System. out. println ( "method () called"); 

} 
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2. Create an Employee class with private name and salary fields. Introduce 
an appropriate constructor to initialize those fields and override 
toString( ) to return a String that specifies the contents of name and 
salary. Introduce a UseEmployee class and create an Employee object in 
UseEmployee's main() method. Also, call that object's toStringO method 
and print the result. Try commenting out the toString( ) method, 
recompiling, and observing the output. 

3. Expand on Exercise 2's UseEmployee application by doing the following: 
First, derive a Salesperson class from Employee and declare a private 
territory field, of type String, in Salesperson. Second, be sure to 
include a Salesperson constructor that properly initializes the Employee 
layer and the territory field. Third, include a toStringO method, in 
Salesperson, that returns a String consisting of name, salary, and 
territory information. Fourth, create a Salesperson object in 
UseEmployee's main( ) method and call that object's toStringO method. 
Finally, print the result. 

4. Suppose you decide to model a vehicle and its engine in source code. 
The engine is represented by an Engine class with a private integer 
numCylinders field. Furthermore, Engine declares a getNumCylinders( ) 
method that returns the contents of that field. The vehicle is repre- 
sented by a Vehicle class with private String name and private Engine 
e fields. Vehicle also declares getName() and getEngine() methods that 
return the references stored in those fields. Furthermore, each class 
has a suitable constructor for recording the number of cylinders in an 
Engine object and recording the vehicle's name and its engine in a 
Vehicle object. Given that information, supply appropriate clone () 
methods to perform shallow cloning in regard to an Engine object and 
deep cloning in regard to a Vehicle object. Also create a CloneDemo class 
with a main() method for running the program. The main() method 
should create a Vehicle object consisting of "Half ton Pickup" (as its 
name) and a six-cylinder engine. After creating that object, clone the 
object. Finally, compare the Vehicle references, each Vehicle's name ref- 
erence, each Vehicle's e reference, and each Vehicle's number of cylin- 
ders. You should observe the following output: 

v2 is a duplicate of v1 
name2 is a duplicate of name1 
e2 is a duplicate of e1 
Number of cylinders natch 

The output indicates that deep cloning has created duplicate String 
objects, referenced by namel and name2, and duplicate Engine objects, 
referenced by el and el. 
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The CloneDemo program is challenging. If you successfully complete 
that program before looking at the answer, you will have a good work- 
ing knowledge of cloning. By the way, from a design perspective, what 
is wrong with CloneDemo? 
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Polymorphism 

The first OOP principle, encapsulation, was explored in Chapter 5 (by way 
of classes and objects). Inheritance, the second OOP principle, was the focus 
of Chapter 6. The current chapter completes an exploration of the OOP 
principle trilogy, by exploring polymorphism. Chapter 7 explores the four 
different categories of polymorphism. As you will learn, only two of those 
categories represent genuine polymorphism. One of the two genuine poly- 
morphism categories is next explored, by way of a discussion on method 
binding. What are abstract classes and what have they got to do with poly- 
morphism? You will find an answer to those questions in this chapter, and 
discover (in an unusual way) how abstract classes and interfaces work 
together. Chapter 7 concludes by discussing RTTI, runtime type informa- 
tion, and shows its usefulness in the context of polymorphism. 
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What Is Polymorphism? 



Java supports the OOP principle of polymorphism. That term comes from 
the Greek and means "many forms" or "many shapes." In the physical 
world, water is a good example of polymorphism. In its natural state, water 
is a liquid. When frozen, that liquid becomes a solid block of ice. But when 
boiled, water turns into a gas. Polymorphism can also be found in computer 
languages. At the computer-language level, there are four kinds of poljmior- 
phism: coercion, overloading, parametric, and inclusion. 

The first kind of polymorphism, coercion polymorphism, refers to a single 
operation serving several types through implicit type conversion. For exam- 
ple, the multiplication operation, which manifests itself in source code 
through the multiplication operator symbol (*), allows you to multiply an 
integer by another integer and a floating-point value by another floating- 
point value. However, if one operand is an integer and the other operand a 
floating-point value, the compiler must coerce (convert) the integer's 
operand type to floating-point. Otherwise, a type error occurs — because 
Java's multiplication operation does not multiply integers by floating-point 
values, or vice versa. Another example of coercion polymorphism involves 
method calls. If a class declares a method with a superclass parameter and 
if a call is made to that method with a subclass object reference, the com- 
piler implicitly coerces (converts) the subclass reference type to the super- 
class reference type. That way, only superclass-defined operations are legal 
(without explicit type casts) in the method. 

The second kind of polymorphism, overloading polymorphism, refers to 
using a single operator symbol or method name for different operations. For 
example, the + operator symbol signifies any one of several operations based 
on its operands' types. If both operands have integer types, the integer addi- 
tion operation takes place. Similarly, if both operands have floating-point 
types, a floating-point operation takes place. Finally, if those operands are 
strings, string concatenation will be performed. Along with its language- 
defined operator overloading, Java also permits method names to overload, 
provided that the number and/or types of each method's parameters differ. 
That way, the same method-name identifier can apply to different opera- 
tions. 

Many developers do not feel coercion and overloading polymorphism repre- 
sent true forms of polymorphism. At close inspection, coercion and overload- 
ing polymorphism are seen as convenient type conversion aids and 
syntactic sugar. In contrast, parametric and inclusion polymorphism are 
considered to be genuine polymorphism. 
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The third kind of polymorphism, parametric polymorphism, refers to a class 
declaration that allows the same field names and method signatures to 
associate with a different type in each instance of that class. For example, 
you might create a Set class with a value field that holds any type of refer- 
enced data item. To allow for proper type checking at compile time, you do 
not want to give that field Object type (as in Object value;) as the compiler 
cannot inform you if the code attempts to perform invalid operations on 
value, because only the JVM knows the actual type of value at runtime. 
However, you do not want to tie value to a specific type in your source code, 
because you lose the benefit of being able to store different object types in 
your Set objects. To achieve the best of both worlds, parametric polymor- 
phism gives you the benefits of compiler type checking — which alerts you to 
attempts to perform invalid operations on value — and allows value to hold 
references to different object types. Probably the best-known example of 
parametric polymorphism is the C++ template language feature. Although 
Java does not officially support parametric polymorphism, developers 
expect Sun to add that support to version 1.5 of Java 2, which is scheduled 
for a 2003 release. 

The final kind of polymorphism, inclusion polymorphism, refers to a situa- 
tion in which a type can be another type's subtype. Every subtype value can 
appear in a supertype context, where the execution of the supertype's oper- 
ations (on that value) results in the execution of the subtype's equivalent 
operations. For that reason, inclusion polymorphism is also known as sub- 
type polymorphism. Inclusion (subtype) polymorphism is the focus of this 
chapter. To understand that kind of polymorphism, you need to understand 
how Java binds method calls to classes and objects. 



Method Binding 



Java lets you declare two kinds of methods in a class, class methods (also 
known as static methods) and instance methods (also known as non-static 
methods). A class method associates with a class, and an instance method 
associates with an instance of that class (that is, an object). When you call 
a method, the JVM binds the method call to either a class or an object, 
depending on whether the method was declared static (a class method) or 
non-static (an instance method). Binding a method call to a class is known 
as static method binding. For a demonstration of static method binding, 
refer to Listing 7.1's SMBDemo source code. 
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Listing 7.1: SMBDemo. Java. 
// SMBDemo.java 



OUTPUT 



class Parent 
{ 

static void someMethod () 
{ 

System. out. println ("Parent's someMethod( ) " ) ; 

} 

} 

class Child extends Parent 
{ 

static void someMethod () 
{ 

System. out. println ("Child's someMethod( ) " ) ; 

} 

} 

class SMBDemo 
{ 

public static void main (String [] args) 
{ 

Parent . someMethod (); 

Child. someMethod (); 

Parent x = new Parent (); 
X. someMethod (); 

X = new Child ( ) ; 
X. someMethod (); 

} 

} 

When run, SMBDemo produces the following output: 

Parent's someMethod() 
Child's someMethod {) 
Parent's someMethod () 
Parent's someMethod () 

The first output line refers to the Parent . someMethod ( ) ; method call, and 
the second output line refers to the Child . someMethod ( ) ; method call. Those 
method calls bind to classes Parent and Child: They do not bind to objects 
created from those classes. At runtime, the JVM notes the class in which 
the method is declared and calls the method in that class. As a result, static 
method binding has nothing to do with objects. 
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To reinforce the fact that static method binding has nothing to do with 
objects, consider the second two output Hnes. Those output hnes originate 
from X . someMethod ( ) ; method calls. Although the first of those two output 
lines seems to reflect an instance method call using a Parent object refer- 
ence stored in x, the JVM treats x . someMethod ( ) ; as Parent . someMethod ( ) ; . 
Furthermore, consider the last output line. Because x contains a reference 
to a Child object, one might expect the output line to display as Child ' s 
someMethod ( ) instead of Parent ' s someMethod ( ) . In fact, if dynamic method 
binding was being used, you would see Child ' s someMethod ( ) . However, 
you only see Parent ' s someMethod ( ) because the JVM treats the final 
x. someMethod (); method call as Parent . someMethod ();. 



TIP 

When calling a class (static) method, do not specify an object reference variable to call 
that method. Specifying an object reference variable obscures the fact that a class 
method is being called and can confuse someone reading your code. Instead, if you are 
calling that method from another class, specify the class name, a period character, and 
the method name (and arguments list) (as in Parent . someMethod () ;). However, if you 
are calling the method from another method in the same class, just specify the method 
name (and arguments list) (as in someMethod {) ;). 



In contrast to static method binding, dynamic method binding occurs when 
a method call binds to an object. For a demonstration of dynamic method 
binding in such a hierarchy, refer to Listing 7.2's DMBDemo source code. 

Listing 7.2: DMBDemo. Java. 
// DMBDemo. java 

class Parent 
{ 

void someMethod () 
{ 

System. out. println ("Parent's someMethod( ) " ) ; 

} 

} 

class Child extends Parent 
{ 

void someMethod () 
{ 

System. out. println ("Child's someMethod( ) " ) ; 

} 

} 



class DMBDemo 
{ 
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Listing 7.2: continued 

public static void main (String [] args) 
{ 

Parent x = new Parent (); 
x.someMethod (); 

X = new Child ( ) ; 
X.someMethod (); 

} 

} 

DMBDemo is similar to SMBDemo, except that each someMethod( ) declaration 
is minus the static keyword. Also, Parent . someMethod () ; and Child. 
someMethod ( ) ; are missing from main( ). When run, DMBDemo produces the 
following output: 

Parent's someMethod () 
Child's someMethod!) 

The first output line reflects a call to Parent's someMethod ( ) method, and the 
second output line reflects a call to Child's someMethod ( ) method. How does 
the JVM know which method to call? At runtime, the JVM uses the refer- 
ence stored in x to identify the correct someMethod ( ) method to call. Once 
that reference has been obtained, the JVM uses that reference to locate 
either Parent's or Child's someMethod ( ) method and passes that reference to 
someMethod( ), as a hidden argument. Although you do not see a correspond- 
ing parameter for that argument in someMethod ( )'s parameter list, you can 
access that argument from within someMethod ( ) (and any instance method) 
by using keyword this. It is that hidden reference (that you access with 
this) that allows an instance method to access the correct copy of instance 
fields (in the same class as the just called instance method) and call other 
instance methods (in the same class as the just called instance method). 

If you were wondering why you cannot call Parent . someMethod () ; or 
Child . someMethod ( ) ; from DMBDemo, keep in mind that no hidden object 
reference is passed to a class method (which is why a class method cannot 
access instance fields and call instance methods in the same class). Because 
DMBDemo's Parent and Child classes declare someMethod ( ) without keyword 
static, their own someMethod ()'s must be called with a hidden object refer- 
ence argument. As a result, the compiler cannot allow Parent. someMethod 
( ) ; or Child . someMethod ( ) ; to occur. 

Java uses dynamic method binding to make inclusion (subtype) polymor- 
phism happen. However, dynamic method binding does not imply inclusion 
(subtype) polymorphism. For example, calling an instance method from 
another instance method in the same class is not an example of inclusion 




09 71710_CH07 11/21/01 12:15 PM Page 251 




Method Binding 251 



(subtype) polymorphism. To make that happen, you need to assign a sub- 
class reference to a superclass variable and call a method declared in a 
superclass but overridden in the subclass. In that scenario, dynamic 
method binding causes the JVM to chooses the subclass's overridden 
method. Collectively, that scenario (which includes dynamic method 
binding) makes inclusion (subtype) polymorphism happen. 

A Tale of Rectangles and Squares 

To continue our exploration of dynamic method binding, consider if a 
square is a kind of rectangle or if a rectangle is a kind of square. Let's 
assume a square is a kind of rectangle. That assumption leads to source 
code that is similar to Listing 7.3's SRDMBDemol source code. 

Listing 7.3: SRDMBDemol .Java. 
// SRDMBDemol .Java 

class Rectangle 
{ 

private double length; 
private double width; 

Rectangle (double length, double width) 

this. length = length; 
this. width = width; 

double getLength () 
return length; 

double width () 
return width; 

double area () 

return length * width; 

} 

class Square extends Rectangle 
{ 
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Listing 7.3: continued 

Square (double length) 
{ 

super (length, length); 

} 

double area () 
{ 

return getLength () * getLength (); 
// Or: return getLength () * getWidth (); 
//Or: return getWidth () * getWidth (); 

} 

} 

class SRDMBDemol 
{ 

public static void main (String [] args) 
{ 

Rectangle r = new Rectangle (10.0, 5.0); 
System. out. println ("Rectangle area = " + r.area ()); 

r = new Square (5.0) ; 

System. out. println ("Square area = " + r.area ()); 

} 

} 

SRDMBDemol produces the following output, when run: 

Rectangle area = 50.0 
Square area =25.0 

SRDMBDemol's main() method and the output show dynamic method binding in 
action. First, a Rectangle object is created and its reference assigns to r. 
Then r.area ( ) is called to return the area of the rectangle (50.0). Second, a 
Square object is created, and its reference assigns to r. Once more, r . area ( ) 
is called to return the area (25.0) of the square. Two different area values 
return because the JVM examines the reference stored in r and calls the 
appropriate area( ) method, based on that reference (dynamic method bind- 
ing). When the appropriate area() method is called, the reference stored in 
r passes to area( ). That method uses that reference to either access the 
appropriate object's length and width fields (in Rectangle's area() method) or 
call the getLength ( ) method (from Square's area() method) with that refer- 
ence (as a hidden argument), so that getLength ( ) can access the appropriate 
object's length field. (Don't forget, you could create two or more Rectangle 
objects and/or two or more Square objects. The this reference passed to 
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areaO (as a hidden argument) distinguishes between Rectangle objects or 
between Square objects. 

There is something most unsatisfying about SRDMBDemol's source code (which 
views a square as a rectangle of equal length and width). Although the 
Rectangle class looks fine, take a look at the Square class. Square overrides 
areaO and inherits the getLength() method, which is fine, but Square also 
inherits the getwidth( ) method — which is not fine. Keep in mind that a 
square has four sides of equal length (unless you like to think of a square 
as having four sides of equal width). Having access to getwidth( ) and 
getLength( ) from Square introduces redundancy into the code: There are two 
ways to extract a square's length. A developer can call either method to 
extract the same quantity. To someone reading such source code and seeing 
calls to getwidth ( ) followed by calls to getLength ( ) , that person might be 
inclined to think that a rectangle is being accessed instead of a square. 

If you assume that a rectangle is a kind of square, you end up with source 
code similar to Listing 7.4's SRDMBDenio2 source code: 

Listing 7.4: SRDMBDemo2. Java. 
// SRDMBDemo2. Java 

class Square 
{ 

private double length; 
Square (double length) 
this. length = length; 

double getLength () 
return length; 

double area () 

return length * length; 

} 

class Rectangle extends Square 
{ 

private double width; 
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Listing 7.4: continued 

Rectangle (double length, double width) 
{ 

super (length); 
this. width = width; 

} 

double area () 
{ 

return getLength () * width; 

} 

} 

class SRDMBDeno2 
{ 

public static void main (String [] args) 
{ 

Square s = new Square (5.0); 

System. out. println ("Square area = " + s.area ()); 
s = new Rectangle (10.0, 5.0); 

System. out. println ("Rectangle area = " + s.area {)); 

} 

} 

When run, SRDMBDemo2 produces the following output: 

Square area =25.0 
Rectangle area = 50.0 

As with SRDMBDemol, SRDMBDemo2 uses dynamic method binding to call the cor- 
rect area( ) method, which the output reinforces. 

Personally, I find SRDMBDemo2's source code to be more satisfying than 
SRDMBDemol 's source code. SRDMBDe[iio2's source code views a rectangle as a 
stretchable square. That source code derives Rectangle from Square, and 
Rectangle only adds those fields and methods needed to differentiate it from 
a Square. Square has no getwidth() method, whereas Rectangle inherits 
Square's getLength () method and adds its own getwidth() method. To access 
a square's length, only the getLength () method can be called. However, to 
access a rectangle's length and width, getLength ( ) and getwidth( ) can be 
called. 

What is the point of the discussion, beyond providing additional examples 
of dynamic method binding that illustrate inclusion (subtj^e) polymor- 
phism? The discussion is about design choices. If you view a Square as a 
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kind of Rectangle, the square has getLength() and getwidth() methods. 
Those methods imply that a square has separate length and width, when a 
square only has a length (or width, if you prefer). But if you view a rectan- 
gle as a kind of square, the square only has a getLength() method — to 
reflect the fact that each side has the same length. Furthermore, a rectan- 
gle has getLengthO and getwidth() methods — to reflect the fact that two 
sides have the same length and two sides have the same width (and that 
length and width are different). 



NOTE 

Using SRDMBDemo2, it is still possible to create a Rectangle that has the same width 
and length. Because the result represents a square instead of a Rectangle, does that 
not violate the design? Yes it does. However, it is possible to do the same thing with 
SRDMBDemol , so that point is moot. Is a square a kind of rectangle or is a rectangle a 
kind of square? You decide — but keep the coding discussion in mind. 



Dynamic Method Binding Versus Switch Logic 

Java's support for dynamic method binding simplifies the introduction of 
inclusion (subtype) polymorphism into Java programs. Suppose Java did 
not support dynamic method binding. Would it still be possible for a pro- 
gram to use inclusion (subtype) polymorphism? Yes, but not in a convenient 
manner. In the absence of dynamic method binding, a program needs 
switch logic and type fields to achieve inclusion (subtype) polymorphism. 



NOTE 

Developers in non-OOP languages (such as C) must use switch logic and type fields to 
achieve inclusion (subtype) polymorphism. In lieu of classes, C programs use structs 
(structures). Structures can contain variable declarations, include the addresses of 
methods. In effect, objects can be simulated in C (at least from an encapsulation per- 
spective). 



How do switch logic and type fields achieve inclusion (subtype) polymor- 
phism? In an object-oriented program, each object's class derives from a 
common class that contains a type field. When an object is created, the 
object's constructor initializes the inherited type field to a value that identi- 
fies the object's class. When processing an array of objects, either a Switch 
decision statement or a chained If-Else decision statement — switch logic — 
examines the value of each object's type field and takes appropriate action, 
based on that value. 

The differences between d3niamic method binding and switch logic and tj^e 
fields can best be understood by comparing two sets of source code to a sin- 
gle kind of program. For example, assume that you create two versions of a 
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EXAMPLE 



program that use inclusion (subtype) polymorphism to get a group of 
animals to make a noise. Call the first version of that program (that uses 
dynamic method binding) Animalsl and the second version (that uses switch 
logic and type fields) Animals2. 

\ I / The Animalsl source code in Listing 7.5 demonstrates inclusion (subtype) 
polymorphism, by way of dynamic method binding. 

Listing 7.5: Animalsl .java. 
// Animalsl . java 

abstract class Animal 
{ 

abstract void makeNoise (); 

} 

class Bear extends Animal 
{ 

void makeNoise () 
{ 

System. out. println ("Growls"); 

} 

} 

class Chipmunk extends Animal 
{ 

void makeNoise () 
{ 

System. out. print In ("Whistles" ) ; 

} 

} 

class Dog extends Animal 
{ 

void makeNoise () 
{ 

System. out. println ("Barks"); 

} 

} 

class Animalsl 
{ 

public static void main (String [] args) 
{ 

Dog joey = new Dog () ; 
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Listing 7.5: continued 

Animal [] menagerie = 
{ 

new Bear ( ) , 
new Chipmunl< ( ) , 
joey 

}; 

for (int i = 0; i < menagerie. length; i++) 
menagerie [i] .mal<eNoise (); 

} 

} 

At runtime, Animalsl prints the following output: 

Growls 

Wfiistles 

Barl<s 




EXAMPLE 



OUTPUT Because Bear, Chipmunk, and Dog subclass Animal, references to their objects 
can be stored in an Animal array. A For loop statement iterates over that 
array. During each iteration, a reference to the appropriate Animal subclass 
object is retrieved from an array element, and the JVM uses that reference 
to locate the correct maloNoise ( ) method, which gets called. That method 
then prints an appropriate noise message. 

The Animals2 source code in Listing 7.6 demonstrates inclusion (subtype) 
polymorphism, by way of switch logic and a type field. 

Listing 7.6: Animals2.]ava. 
// Animals2.iava 

abstract class Animal 
{ 

final static int BEAR = 0; 
final static int CHIPMUNK = 1; 
final static int DOG = 2; 

int animalType; 

Animal (int animalType) 
{ 

this. animalType = animalType; 

} 

} 



class Bear extends Animal 
{ 
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Listing 7.6: continued 
Bear () 
{ 

super (BEAR); 

} 

void growl () 
{ 

System. out. println ("Growls"); 

} 



class Chipmunk extends Animal 
{ 

Chipmunk () 
{ 

super (CHIPMUNK); 

} 

void whistle () 
{ 

System. out . println ( "Whistles" ) ; 

} 



class Dog extends Animal 
{ 

Dog 0 
{ 

super (DOG); 

} 

void bark () 
{ 

System. out. println ("Barks"); 

} 



class Animals2 
{ 

public static void main (String [] args) 
{ 

Dog joey = new Dog ( ) ; 

Animal [] menagerie = 
{ 
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Listing 7.6: continued 

new Bear ( ) , 
new Chipmuni< ( ) , 
joey 

}; 

for (int i = 0; i < menagerie. length; i++) 
switch (menagerie [i] .animalType) 
{ 

case Animal. BEAR: 

((Bear) menagerie [i]). growl (); 
break; 

case Animal. CHIPHilUNK: 

((Chipmunl<) menagerie [i]). whistle (); 
break; 

case Animal. DOG: 

((Dog) menagerie [i]).bark (); 

} 

} 

} 

At runtime, Aninials2 prints the following output: 

Growls 

Whistles 

Barks 



OUTPUT Animals2's type field is an integer animalType field variable, declared in class 
Animal. The use of constants BEAR, GHIPH/IUNK, and DOG clarifies the source 
code. Each of the Bear, Chipmunk, and Dog classes declares a constructor and 
calls the Animal constructor with an appropriate constant to identify its 
class. At runtime, for each of the menagerie array's objects, switch logic tests 
animalType and calls the appropriate method to make some noise — after 
performing a cast. Animals2 produces output that's the same as the output 
produced by Animalsl . 

Some of you might be crying foul at this point. After all, both Animalsl and 
Animals2 use dynamic method binding to call instance methods. The differ- 
ence is the way dynamic method binding is used. Animalsl declares a 
makeNoiseO method in the Animal class and overrides that method in each 
subclass. At runtime, the JVM chooses the appropriate makeNoiseO subclass 
method to call based on the reference stored in each menagerie element. In 
contrast, Animals2 declares noise-specific methods (such as growl () and 
barkO) in each subclass and uses switch logic and a type field to identify 
the type of each object — and call the appropriate method. Both programs 
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illustrate inclusion (subtype) polymorphism. However, the first program 
uses dynamic method binding to call the appropriate makeNoisei ) method, 
and the second program uses switch logic and a type field to identify the 
appropriate noise-making method to call. Then, dynamic method binding 
calls that exact method (which, by itself, is not a demonstration of inclusion 
[subtype] polymorphism). 

Apart from the inconvenience of casting a supertype to a subtype (that is, 
the object's actual type), there are some problems with traditional switch 
logic and type fields: 

• Suppose a developer forgets to include switch logic. In a simple pro- 
gram (such as Ani[nals2), it would seem that forgetting switch logic 
would never happen. However, consider a large program where many 
instances of switch logic are needed to ensure that inclusion (subtype) 
polymorphism is used in all appropriate places. 

• Suppose there is a requirement to introduce a new type and a devel- 
oper forgets to make appropriate changes in all places. For example, 
suppose a Tiger type needs to be inserted in Animals2 and the devel- 
oper forgets to add a case to the Switch decision statement. 

• When adding or removing classes, you must modify every piece of 
switch logic. Tracking down all places that use such logic can be prone 
to error (and certainly consumes time). 



Abstract Classes 



In the previous section, the source code to Animalsl and Animals2 introduced 
keyword abstract as part of their Animal class declarations. Furthermore, 
abstract was introduced as part of AnimaH's makeNoiseO method declaration 
(in class Animal). Those classes and method were declared to be abstract 
because it doesn't always make sense to create objects from classes. For 
example, what kind of animal does an Animal object represent? As a second 
example, suppose you are modeling a hierarchy of vehicles, and that hierar- 
chy consists of a vehicle class (at the top), a Car class (derived from 
Vehicle), and Luxurycar, Sportscar, and Familycar classes (derived from Car). 
What does it mean to create an object from Vehicle? That object represents 
a vehicle, but what kind of vehicle does the object represent? Furthermore, 
what does it mean to create an object from Car? That object represents a 
vehicle that is a car, but it doesn't tell you what kind of car it represents. In 
contrast, creating objects from Luxurycar, Sportscar, or Familycar tells you a 
lot about those objects. (They represent luxury cars, sports cars, or family 
cars.) What we are dealing with is a situation where generic concepts (such 
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EXAMPLE 



as vehicle) are at the top of a hierarchy and specific concepts (such as lux- 
ury car) are at the bottom of the hierarchy. Because it usually doesn't make 
sense to create objects from classes apart from those at or near the bottom 
of a class hierarchy, it should be possible for Java to prevent developers 
from creating objects from classes in the upper reaches of the hierarchy. 
Java provides that capability, in the form of abstract classes. 

An abstract class is declared with the abstract keyword. For example: 
abstract class Vehicle {}. Objects can't be created from abstract classes. 

CAUTION 

The compiler reports an error if it encounters a class instance creation expression that 
attempts to create an object from an abstract class. 

Within an abstract class, you can declare anything that can be declared in a 
nonabstract class. Developers normally introduce fields and methods into 
abstract classes that are common to various subclasses. The idea is to fac- 
tor out commonality from subclasses to eliminate redundancy. Some of the 
methods in an abstract class can, themselves, be declared abstract. They 
are declared abstract to signify that subclasses contain their own versions 
of the abstract methods and also to signify that the abstract methods are 
meaningless by themselves in the context of the abstract class. For exam- 
ple, in the previous Animals 1 class, [nakeNoise( ) was declared abstract 
because each animal makes its own kind of noise and what kind of noise is 
made by a generic animal? 

An abstract method is declared, in an abstract class, with the abstract key- 
word. For example: abstract void steer ( ). If you declare an abstract 
method in a class, the class must also be declared as an abstract class. 

CAUTION 

The compiler reports an error if it encounters a class with a method declared abstract, 
but the class is not declared abstract. 

To see how abstract classes and methods are used, you can refer back to 
Listing 7.5's Animalsl source code. You can also examine Listing 7.7's 
Vehicles source code. 

Listing 7.7: Vehicles. java. 
// Vehicles. java 

abstract class Vehicle 
{ 

abstract void steer ( ) ; 

} 
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Listing 7.7: continued 
class Bicycle extends Vehicle 
{ 

void steer () 
{ 

System. out. println ("Turn handlebars"); 

} 

} 

abstract class Car extends Vehicle 
{ 

void steer () 
{ 

System. out. println ("Turn steering wheel"); 

} 

} 

class FamilyCar extends Car 
{ 
} 

class Vehicles 
{ 

public static void main (String [] args) 
{ 

Vehicle [] v = 
{ 

new Bicycle ( ) , 
new FamilyCar () 

}; 

for (int i = 0; i < v. length; i++) 
V [i] .steer (); 

} 

} 

When run, Vehicles produces the following output: 

Turn handlebars 
Turn steering wheel 

Vehicles declares several classes. Notice the abstract vehicle class and its 
abstract steer () method. Because there is no point in creating objects from 
Vehicle, that class is made abstract. Also, because different kinds of vehi- 
cles are steered in different ways, it makes sense to leave steer ( ) as an 
abstract method. 
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A Bicycle class derives from Vehicle and overrides steer ( ) — to emphasize 
that bicycles are steered by turning their handlebars. By providing a code 
body, Bicycle's overridden steer ( ) method is changed from abstract to non- 
abstract. 

A Car class also derives from Vehicle. Unlike Bicycle, Car is abstract 
because it doesn't make sense to create Car objects. However, Car's steer () 
method is changed from abstract to nonabstract, because cars are typically 
steered in the same way (by turning a steering wheel), and it doesn't make 
sense to place redundant code in FamilyCar and other future subclasses 
of Car. 

TIP 

Consider declaring classes that represent generic concepts (such as vehicles, animals, 
bank accounts, and so forth) abstract. As a rule of thumb, any class that can have sub- 
classes is probably a good candidate for an abstract class. Which classes should be 
abstract and which classes should not be abstract will change from one program to 
another and is more of a design issue than anything else. As you gain experience with 
Java OOf? you'll start to develop a "feel" for what should be abstract and what should 
not be abstract. 

What have abstract classes got to do with polymorphism; inclusion (sub- 
type) polymorphism, to be specific? Inclusion (subtype) polymorphism works 
in the context of a class hierarchy. You often create a reference variable 
using the name of an abstract class (when you wish to refer to a common 
hierarchy of objects in a generic fashion) and assign a reference to a non- 
abstract subclass object to that variable. Then, you call one of that class's 
nonabstract or abstract methods. Dynamic method binding results in the 
appropriate subclass method being called. That is exactly what Animalsl 
and Vehicles do. As you can see, abstract classes and inclusion (subtype) 
polymorphism work together to remove redundancy and ensure the 
appropriate subclass methods get called. 

Abstract Classes Versus Interfaces 

Nothing seems to confuse Java developers more than when to use an 
abstract class and when to use an interface. After all, an abstract class con- 
sisting of abstract methods is essentially the same as an interface, or is it? 
The reality is that both entities serve different purposes and are typically 
combined in a program to solve certain problems. To find out how they do 
that, it is necessary to understand software development from type-centric 
and implementation-centric viewpoints. 

When you design an object-oriented program, you typically think in terms 
of that program's types. In other words, what kinds of values (integers. 
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characters, and so on) will the program manipulate and what kinds of 
operations will be performed on those values? For example, a set of integers — 
and addition, subtraction, multiplication, and division — represent a type- 
centric view of the integer type. As a second example, a set of character 
sequences and operations to determine sequence length, as well as to 
extract a character from a specific position in a sequence (and so on), is a 
type-centric view of Java's String type. 

When you actually write a program's source code, you typically think in terms 
of what keywords to use, what classes to use, and so on. In other words, you 
are thinking about how to implement a design. The implementation-centric 
viewpoint focuses on the internal representation of type values and the cod- 
ing of operations that manipulate those values. Think of the implementation- 
centric viewpoint as making it possible to write a program that can create 
variables of a type and execute code that performs operations on that type. 
For example, integers can be implemented using 32 bits of memory, reserv- 
ing the most significant bit as the sign bit (0 for positive, 1 for negative), 
and storing the remaining 31 bits in twos-complement form — which I dis- 
cuss in Chapter 14 — if the integer is negative. Also, the +, -, *, and / sym- 
bols allow the developer to identify operations to be performed on the 
integer values, and the underlying code for those operations accesses the 
internal representation to carry out the operations. As a developer, you rely 
on the compiler and the JVM to take care of implementation concerns for 
primitive types (such as integer). However, if you need to implement your 
own type in source code (which is known as a reference type, because vari- 
ables of that type reference objects), you must think about the type's class 
structure, fields, methods, the code in those methods, and so on. That is an 
implementation-centric view of a type. 

Enter classes and interfaces. Classes divide into nonabstract (also known 
as concrete) and abstract categories. From a type-centric viewpoint, a con- 
crete class, an abstract class, and an interface are identical. They all define 
a type as a set of values and a set of operations. From an implementation- 
centric viewpoint, however, they are very different entities. A concrete class 
provides an implementation for each tj^e operation (through a method). An 
abstract class optionally provides an implementation for each type opera- 
tion (through non-abstract methods). (If a type operation is not to have an 
implementation, the abstract class affixes the abstract ke3rword to the cor- 
responding method signature.) Finally, an interface provides no implemen- 
tations for its type operations. (You can declare method signatures only in 
an interface. That is the equivalent of specifying the abstract kejrword.) 

At this point, I am going to suggest something unusual. I ask you to log 
onto the Internet and surf to a Web page at http : / /www. j avaworld . com/ 
i avawo rid/ iw-09 -2001 /iw-0921 - interface. html. On that Web page, you will 
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find a JavaWorld article titled Maximize flexibility with interfaces and 
abstract classes. That article is written by Wm. Paul Rogers and does a 
marvelous job of clarifying when to use abstract classes and when to use 
interfaces. Because I have never found a better explanation, because the 
explanation is somewhat involved, and because I have no intention of dupli- 
cating what Mr. Rogers has written, I think you owe it to yourself to read 
that article. Because of everything you have previously read in this chapter, 
you should have little difficulty with that article's material. 

After you complete reading that article, you are left with the following 
conclusion: An abstract class serves as a repository for common subclass 
implementation. In contrast, an interface introduces a type into a program. 
When combined, an abstract class implements some of an interface's type 
operations as methods. Subclasses can override those methods, and inclu- 
sion (subtype) polymorphism (via dynamic method binding) makes it 
possible to call the right methods. The result is maximum flexibility in 
your implementation and type structures. 



Runtime Type Information 




Often, you must determine, at runtime, whether an object belongs to a spe- 
cific type. That kind of dynamically-determined type information is known 
as runtime type information (RTTI). 

Java allows RTTI to be obtained by way of the relational type checking 
operator — identified by keyword instanceof (introduced in Chapter 3). For 
example, the expression e instanceof Employee determines whether the 
object referenced by e belongs to the Employee type. If so, instanceof returns 
true. Otherwise, instanceof returns false. The true/false return value is 
known as runtime type information. 

\ I / The RTTI source code in Listing 7.8 demonstrates the use of instanceof to 
^1 determine whether an object, referenced by variable c, belongs to Circle, 
Point, and Shape tj^es. 



EXAMPLE 



Listing 7.8: RTTI . java. 
// RTTLjava 



interface Shape 

{ 

} 



class Point implements Shape 

{ 

} 
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Listing 7.8: continued 

class Circle extends Point 

{ 

} 

class RTTI 
{ 

public static void main (String [] args) 
{ 

Circle c = new Circle (); 

System. out. println (c instanceof Circle); 
System. out. println (c instanceof Point); 
System. out. println (c instanceof Shape); 

} 

} 

If you run RTTI, true appears on the three output Hnes. Although that con- 
sistency might seem surprising, it isn't, because c references a Circle 
object; c references a Point object (by virtue of implementation inheritance); 
and c references a Shape object (by virtue of interface inheritance). 

Being able to determine (at runtime) whether an object belongs to a specific 
type is a useful capability. For example, suppose you are writing a program 
that calculates the payroll for a company. That company's employees consist 
of a CEO (with a weekly salary), commissioned employees (that is, employ- 
ees whose paychecks are determined by a base weekly salary and a specific 
amount for each item that they sell in a week) and pieced employees (that 
is, employees whose paychecks are determined by a specific amount for 
each piece they produce in a week). 

Before you write the program, you decide to create an abstract Employee 
class that describes an employee. That class records the employee's name 
and declares an abstract payment () method for returning an employee's 
weekly payment. You decide to take advantage of polymorphism and 
create an array of Employee objects from GEO, CommissionedEmployee, and 
PiecedEmployee classes — to reduce the size of the program. However, you are 
told that a $50 bonus must be given to pieced employees (only), because 
they have been doing an excellent job. Ideally, you would like to use a 
loop that calls each Employee object's payment ( ) method. However, that $50 
bonus throws a slight wrinkle into your plans. Fortunately, by using 
instanceof, you can call payment () for each "Employee" object and add $50 to 
the weekly pay of those employees represented by PiecedEmployee objects. 
You can do that without significantly adding to the code, as the Payroll 
source code in Listing 7.9 demonstrates. 




EXAMPLE 
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Listing 7.9: Payroll, java. 
// Payroll. java 

abstract class Employee 
{ 

private String name; 

Employee (String name) 
{ 

this. name = name; 

} 

String getName () 
{ 

return name; 

} 

abstract double payment (); 

} 

final class CEO extends Employee 
{ 

private double weeklySalary; 

CEO (String name, double weeklySalary) 
{ 

super (name); 

this .weeklySalary = weeklySalary; 

} 

double payment () 
{ 

return weeklySalary; 

} 



final class CommissionedEmployee extends Employee 
{ 

private double baseSalary; // Base weekly salary 
private double commission; // Amount paid per item sold 
private int numltemsSold; 

CommissionedEmployee (String name, double bs, double c, int nis) 
{ 

super (name); 
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Listing 7.9: continued 

baseSalary = bs; 
commission = c; 
numltemsSold = nis; 

} 

double payment () 
{ 

return baseSalary + commission * numltemsSold; 

} 



final class PiecedEmployee extends Employee 
{ 

private double amtPerPiece; 
private int numPieces; 

PiecedEmployee (String name, double app, int np) 
{ 

super (name); 

amtPerPiece = app; 
numPieces = np; 

} 

double payment () 
{ 

return amtPerPiece * numPieces; 

} 



class Payroll 
{ 

public static void main (String [] args) 
{ 

Employee [] employees = 
{ 

new CEO ("Jane Doe", 5000.0), 

new CommissionedEmployee ( "Esther Jones" , 400.0, 15.0, 23), 
new PiecedEmployee ("John Doe", 4.5, 123) 

}; 

for (int i = 0; i < employees. length; i++) 
{ 

System. out. print (employees [i].getName () + ": "); 

System. out. println ((employees [i] instanceof PiecedEmployee) 
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Listing 7.9: continued 



? employees [i]. payment () + 50. 
: employees [i]. payment ()); 



OUTPUT 




EXAMPLE 



} 

Payroll produces the following output: 

Jane Doe: 5000.0 
Estfier Jones: 745.0 
Jofin Doe: 603.5 

Each class, apart from Payroll, is declared final to prevent that class from 
being subclassed. The rationale is to prevent anyone from changing the 
employee weekly payment rules. If you examine the For loop statement, 
you'll see instanceof being used to make sure that an Employee object is 
really a PiecedWorl<er object before a $50 bonus is added. 

The relational tj^e checking operator is also helpful when casting an object 
reference from a supertype to a subtype. If an attempt is made to cast from 
a supertype to a subtype, and the object reference is not of that subtype, a 
ClassCastException object is thrown to the JVM. 

✓ To learn about exceptions, see "Wiiat Are Exceptions?," p. 334. 

How can instanceof be used to help prevent ClassCastExceptions? For an 
answer, consider a program that models a variety of geometric shapes. To 
begin, that program consists of a Siiape interface, with an area( ) method 
that returns a shape's area. Also, that program introduces Point, Circle, 
and Square classes (to model various shapes), where Circle subclasses Point, 
and all classes implement Siiape. Finally, a Siiapes class with a main( ) 
method that loops through an array of Shiape objects and prints the area of 
each Siiape is introduced. For each Siiape object, a call is made to Siiape- 
specific methods, and their return values print. The Siiapes application in 
Listing 7.10 demonstrates that. 

Listing 7.10: shapes. Java. 
// Siiapes. java 



interface Shape 
{ 

double area () 

} 
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Listing 7.10: continued 

class Point implements Shape 
{ 

private double x, y; 

Point (double x, double y) 

this.x = x; 
this.y = y; 



double getx {) 
return x; 



double getY {) 
return y; 



public double area () 
return 0.0; 



class Circle extends Point implements Shape 
{ 

private double radius; 

Circle (double x, double y, double radius) 
{ 

super (X, y); 

this. radius = radius; 

} 

double getRadius () 
{ 

return radius; 

} 

public double area () 
{ 
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Listing 7.10: continued 

return Math. PI * radius * radius; 

} 

} 

class Square implements Shape 
{ 

private double length; 
Square (double length) 
this. length = length; 



double getLength () 
return length; 



public double area () 
return length * length; 

} 

class Shapes 
{ 

public static void main (String [] args) 
{ 

Shape [] shapes = 
{ 

new Circle (52.5, 32.6, 4.7), 
new Square (10.0) , 
new Point (4.5, 5.5) 

}; 

for (int i = 0; i < shapes . length; i++) 
{ 

System. out. println ("Area = " + shapes [i].area ()); 

if (shapes [i] instanceof Point) 
{ 

double X = ((Point) shapes [i]).getx (); 
double y = ((Point) shapes [i]).getY (); 
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Listing 7.10: continued 

System. out. println {"Point: (x = " + x + " , y = " + y 
+ ")"); 

} 

else 

if (shapes [i] instanceof Circle) 
{ 

double X = ((Circle) shapes [i]).getx (); 
double y = ((Circle) shapes [i]).getY (); 
double r = ((Circle) shapes [i] ) .getRadius (); 

System. out. println ("Circle: (x = " + x + " , y = " + y 
+ », r = " + r + ")"); 

} 

else 

if (shapes [i] instanceof Square) 
{ 

double 1 = ((Square) shapes [i] ) .getLength (); 



System. out. println ("Square: (length = " + 1 + ")"); 

} 




} 

Shapes' main( ) method uses instanceof to make sure that an object is of a 
certain type before casts are used to call that object's methods. That safe- 
guard prevents the possibility of ClassCastException objects being thrown 
during a cast operation. Before you examine the program's output, there 
are a couple of items to note. First, the Shape interface's area( ) method is 
not declared public, whereas the area() methods in Circle, Point, and 
Square are public. The reason is that Java regards an interface's methods as 
public and does not allow a class to make their access more restrictive. (To 
improve clarity, you could add keyword public to Shape's declaration of 
area().) The second item to note is Math. PI. PI is a constant, declared in the 
Math class, that represents the mathematical value 3.14159.... 



✓ To learn about Math, see "Essential Math Classes," p. 589. 

And now for the output: 

Area = 69.39778171779854 
c^*/B^ Point: (X = 52.5, y = 32.6) 

Area = 100.0 

J Square: (length = 10.0) 

OUTPUT Area = 0.0 

Point: (X = 4.5, y = 5.5) 
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Look closely at the output and you'll discover something strange: No infor- 
mation regarding the Circle object appears, even though a Circle object is 
part of the Shape array. What's happening? The first If in the chained If- 
Else decision statement uses instanceof to determine whether a "Shape" 
object is an instance of Point. Because a Circle is a Point, instanceof 
returns true, and the first If executes, which causes information regarding 
a Point to print. To print the Circle information, you must switch the order 
of the first two If expressions, so that instanceof tests for a Circle before 
testing for a Point. 



CAUTION 

When using instanceof to obtain runtime type information, you must be careful of the 
order in which instanceof expressions appear in a chained IfElse decision statement. 
If you test an object reference against a supertype, before testing against a subtype, 
the subtype test will never occur. 



What's Next? 



This chapter's coverage of the final OOP principle, polymorphism, brings 
us to the end of a journey into Java's support for the three fundamental 
OOP principles. At this point, you might want to visit the Java Language 
Specification and see what it has to say about those Java features that are 
relevant to each principle. When you finish, turn to the next chapter and 
learn how to initialize and finalize objects. Also, the next chapter teaches 
Java's garbage collection mechanism, and Java's ability to nest classes in 
other classes (and even in methods or expressions). 

Before you move on to the next chapter, test your understanding of the 
current chapter by completing the Reviewing It, Checking It, and Applying 
It activities. 

NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers" at the end of the book. 




REVIEW 



Reviewing it 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. What is the difference between an abstract class and an interface? 



2. Are static methods (that is, class methods) polymorphic? 
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3. If objects cannot be created from abstract classes, why do developers 
often place constructors in those classes? 

4. What would happen if you create a subclass of an abstract superclass 
and do not override its abstract method(s)? 

5. What is so great about parametric polymorphism? 



Checking It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. Which of the following is not an example of polymorphism? 

a. Calling a subclass method by way of a superclass object reference 
variable 

b. Overriding methods 

c. Overloading methods and having the compiler choose the correct 
method after examining a method call's argument list 

d. Operator overloading 

2. Which of the following statements is false? 

a. An abstract class can also be declared final. 

b. char [] c = { 'A' }; boolean b = c instanceof char []; is valid 
source code. 

c. Inclusion polymorphism promotes extensibility in that new sub- 
types can be introduced that respond to supertype operations 
without affecting existing source code or class files. 

d. Unlike abstract classes, interface fields must be constant. 
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3. Which of the following is not a problem with switch logic? 

a. A developer might forget to include switch logic where required. 

b. A developer might forget to make all necessary changes to every 
occurrence of switch logic when supporting a new type. 

c. A developer might forget to use instanceof . 

d. When called to remove a type, a developer might forget to recom- 
pile source files after removing all evidences of a new type. 

4. Which of the following is not regarded as a fundamental OOP 
principle? 

a. Composition 

b. Polymorphism 

c. Encapsulation 

d. Inheritance 

5. Which of the following statements is true? 

a. Abstract classes cannot have constructors. 

b. instanceof cannot be used to test whether null is an instance of 
either a class type or an interface type. 

c. Dynamic method binding is used to call static methods. 

d. A chained If-Else decision statement and a type field is an exam- 
ple of switch logic. 

6. Which of the following kinds of polymorphism is also known as sub- 
type polymorphism? 

a. Coercion 

b. Overloading 

c. Inclusion 

d. Parametric 

7. When an instance method is called, a hidden object reference is passed 
to that method so the method can access the correct object's fields and 
call the correct object's methods. How do you refer to that hidden 
reference in source code? 

a. Use super 

b. Use this 
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c. Use switch logic and a type field 

d. Use dynamic method binding 

8. If a class declares a method with a superclass parameter, and if a call 
is made to that method with a subclass object reference, the compiler 
implicitly converts the subclass reference type to the superclass 
reference type. What is that operation known as? 

a. Coercion polymorphism 

b. Overloading poljonorphism 

c. Static method binding 

d. Subtype poljmiorphism 

9. Suppose you have three classes: A, B, and C. Suppose C is a subclass of 
B and B is a subclass of A. Now, suppose you create an object from c 
and assign that object's reference to C reference variable x. Which of 
the following expressions returns true? 

a. X instanceof A 

b. X instanceof B 

c. X instanceof C 

d. All of the above 

10. What kind of scenario best represents a generic concept? 

a. A concrete class at the top of a hierarchy 

b. An abstract class at the bottom of a hierarchy 

c. A concrete class at the bottom of a hierarchy 

d. An abstract class at the top of a hierarchy 

True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. An abstract class's abstract methods do not need to be implemented in 
that class's immediate nonabstract subclass. 

True/False 

2. Java uses dynamic method binding to achieve subtype polymorphism. 
True/False 
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3. Overloading polymorphism is not considered to be a true kind of poly- 
morphism. 

True/False 

4. Abstract classes whose methods are all abstract are the same as inter- 
faces. 

True/False 

5. The relational type checking operator can be used to determine 
whether an object belongs to an interface type. 

True/False 

6. Java currently supports parametric polymorphism. 
True/False 

7. Switch logic consists entirely of either a Switch decision statement or 
a chained If-Else decision statement. 

True/False 

8. If an object is created from a subclass, instanceof can be used to show 
that the object is also a superclass object. 

True/False 

9. Abstract classes are used to represent specialized concepts (such as a 
savings account). 

True/False 

10. To prevent a cast-related problem, casting an object reference variable 
from a superclass type to a subclass type should be performed after 
using instanceof to determine whether the object was created from 
that subclass. 

True/False 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

APPLY ° 

1. What is wrong with the following MediaManager application source 
code? 
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// MediaManager. java 

abstract class Media 
{ 

private String title; 

Media {String title) 
{ 

this. title = title; 

} 

String getTitle () 
{ 

return title; 

} 

abstract void viewMedia (); 

} 

class PrintMedia extends Media 

{ 

} 

class Book extends Media 
{ 

Book (String title) 

{ 

} 

void viewMedia () 
{ 

System. out. println ("Read by scanning print and images"); 

} 



class Magazine extends Media 
{ 

void viewMedia () 
{ 

System. out. println ("Read by scanning print and images"); 

} 

} 

class CDROM extends Media 

{ 

} 

class MediaManager 
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{ 

public static void main (String [] args) 
{ 

Media [] m = 
{ 

new Book ("Java 2 By Example"), 
new Magazine ( "JavaWorld" ) , 
new CDROM 0 



} 



} 



for (int i = 0; i < m. length; i++) 
{ 

System. out. println (m [i].getTitle () 
m [i] .viewMedia () ; 

} 



2. Assuming a Shape interface with a draw( ) method and assuming a 
Shape array named shapes, write a code fragment that draws each 
shape in a polymorphic manner. 

3. Take Exercise I's MediaManager source code, and after you have 
corrected it, modify that code to use switch logic. 
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Initializers and Nested Classes 

Classes and objects must be initialized before they're used. That task is 
performed by initializers. When the time arrives for an object to "die," 
Java's garbage collection facility automatically destroys that object. 
However, before the garbage collector destroys the object, it calls that 
object's finalizer — a process known as finalization — to give the object an 
opportunity to release acquired resources. This chapter explores initializers 
(and the complementary garbage collection and finalization features). Also, 
nested classes — classes declared within classes or blocks (or even as parts 
of expressions) — are explored. 
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Initializers 



Before a program can make use of a class or an object, that class or object 
must initialize (that is, set the state of its fields to known values and 
acquire all necessary resources). Initialization prepares the class or object 
for use during a program's execution. If the class or object does not initial- 
ize, it will not work properly. Although it is common to think of initializa- 
tion in terms of assigning values to variables, initialization is so much 
more. For example, initialization might involve registering a database dri- 
ver, acquiring those resources necessary to playing a movie, opening a file 
and reading its contents into memory (and closing that file), and so on. 
Anything that prepares a class or object for use in a program is known as 
initialization. 

Java supports initialization via initializer language features. Because Java 
handles class initialization differently from object initialization, and 
because classes initialize before objects, we first explore class initialization 
via class initializers. Later, we explore the use of instance initializers to ini- 
tialize objects. 

Class Initializers 

Java programs consist of classes. Before a program can create an object 
from a class, that class must load, by way of Java's class loader, and suc- 
cessfully verify, by way of Java's bytecode verifier. Once done, that class 
initializes. The simplest kind of class initialization is the JVM's automatic 
initialization of class fields to default values. That kind of class initializa- 
tion can be thought of as the default class initializer. 

Listing 8.1's Classlnitializerl source code demonstrates the default class 
initializer initializing various class fields to default values. 

Listing 8.1: classlnitializerl .Java 
// Classlnitializerl . java 

class Classlnitializerl 
{ 

static boolean bool; 
static byte by; 
static char ch; 
static double d; 
static float f; 
static int i; 
static long 1; 
static short sh; 
static String str; 




EXAMPLE 
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Listing 8.1: continued 

public static void main (String [] args) 
{ 

System. out. println ("bool = " + bool); 
System. out. println ("by = " + by); 
System. out. println ("ch = " + ch); 
System. out. println ("d = " + d); 
System. out. println ("f = " + f); 
System. out. println ("i = " + i); 
System. out. println ("1 = " + 1); 
System. out. println ("sh = " + sh); 
System. out. println ("str = " + str); 

} 

} 

Classlnitializerl introduces a variety of class fields by way of the static 
keyword. No explicit values assign to any of those fields. But when you run 
Classlnitializerl, you see the following output: 




i = 0 
1 = 0 
sh = 0 



str = null 

A close look at Classlnitializen's output reveals false, 0, 0.0, and null. 
Those values are the type-oriented representations of default values. They 
represent the result of all bits in each class field having been automatically 
set to zero by the default class initializer. 

NOTE 

In the preceding output, you do not see a value beside c = because c's default value 
interprets as the non-displayable null value. 

The next simplest kind of class initialization is the explicit initialization of 
class fields to values. Each class field explicitly initializes to a value via a 
class field initializer. Think of a class field initializer as consisting of the 
simple assignment operator followed by an expression whose value assigns 
to a class field, as in static boolean first = true;. 
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EXAMPLE 



Listing 8.2's Classlnitializer2 source code extends the previous 
Classlnitializerl source code by introducing several class field initializers. 
Those initializers evaluate expressions and initialize their associated class 
fields to the results of those expression evaluations. 

Listing 8.2: Classlnitializer2. java 
// Classlnitializer2. java 



class Classlnitializer2 
{ 

static boolean bool = true; 

static byte by = 20; 

static char ch = 'X' ; 

static double d = 8.95; 

static float f = 2.1f; 

static int i = 63; 

static long 1 = 22L; 

static short sh = 25000; 

static String str = "test"; 



public static void main (String [] args) 
{ 



System. out 


println 


( "bool 


= " + bool 


System. out 


println 


("by = 


" + by); 


System. out 


println 


("ch = 


" + ch); 


System. out 


println 


("d = " 


+ d); 


System. out 


println 


("f = " 


+ f); 


System. out 


println 


( " i = " 


+ i); 


System. out 


println 


("1 = " 


+ 1); 


System. out 


println 


("sh = 


" + sh); 


System. out 


println 


("str = 


" + str); 



} 

} 

In Classlnitializer2, each class field initializer explicitly assigns the result 
of an expression to a class field. When run, Classlnitializer2 produces the 
following output: 




i = 63 
1 = 22 
sh = 25000 
str = test 
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What is responsible for executing class field initializers? The answer is a 
special JVM-level method named <clinit>. After the default class initializer 
zeroes the bits of all class fields, the JVM executes that method. 

The <clinit> method takes no arguments and returns nothing. The com- 
piler creates that method when it detects the presence of at least one class 
initializer in the class being compiled. Within <clinit>, the compiler places 
bytecode instructions to execute class field initializers. To see what the 
bytecode instructions for Classlnitializer2's <clinit> method look like, 
examine the following code fragment: 

0 iconst_1 

1 putstatic ClassInitializer2/bool Z 
4 bipush 20 

6 putstatic Classlnitializer2/by B 

9 bipush 88 

11 putstatic Classlnitializer2/ch C 

14 ldc2_w #8.950000 

17 putstatic Classlnitializer2/d D 

20 Idc #2.100000 

22 putstatic Classlnitializer2/f F 

25 bipush 63 

27 putstatic Classlnitializer2/i I 

30 ldc2_w #22 

33 putstatic Classlnitializer2/1 J 

36 sipush 25000 

39 putstatic Classlnitializer2/sh S 

42 Idc "test" 

44 putstatic Classlnitializer2/str Ljava/lang/String; 

47 return 

Each line in the code fragment presents a number and a bytecode instruc- 
tion. The number identifies the instruction's zero-based address and is not 
important to the following discussion. 

The first bytecode instruction, iconst i, pushes integer constant 1 onto a 
stack, and the second putstatic Classlnitializer2/bool z instruction pops 
that constant from the stack and assigns it to boolean class field b. (The 
Boolean true value represents as integer constant i in Sun's JVM.) The z 
appearing to the right of the putstatic instruction identifies the type of bool 
as Boolean. Similarly, B identifies the byte type, C identifies the character 
type, D identifies the double-precision floating-point type, F identifies the 
floating-point type, I identifies the integer type, J identifies the long integer 
type, and S identifies the short integer type. 

The bipush, Idc, ldo2_w, and sipush instructions push other constants onto 
the stack, and their respective putstatic instructions pop those values from 
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EXAMPLE 



the stack before assigning them to various class fields. The final return 
instruction causes execution to leave the <clinit> method. At that point, 
the main() method (in Classlnitializer2) starts to execute. 

For some programs, you might find yourself needing to write a class field 
initializer that refers to a previously declared class field. Java supports 
that activity by letting you specify the name of a previously declared class 
field in the expression portion of a subsequently declared class field's class 
field initializer. 

To see how simple it is to refer to a previously declared class field from a 
subsequently declared class field's class field initializer, examine Listing 
8.3's Classlnitializer3 source code. 

Listing 8.3: ClassInitializerS. java 
// ClassInitializerS. java 

class ClassInitializerS 
{ 

static int classFieldl = 1 ; 
static int classField2 = 1 + classFieldl ; 

public static void main (String [] args) 
{ 

System. out. println (classFieldl ) ; 
System. out. println (classField2) ; 

} 

} 

ClasslnitializerS declares class field classFieldl and explicitly initializes 
that field to 1. Then, ClasslnitializerS declares class field classField2 and 
refers to classFieldl in classField2's class field initializer expression. When 
run, Classlnitializer3 produces the following output: 

Although Java allows you to reference class fields in a backward fashion, it 
OUTPUT is not possible for a class field to refer to a class field in a forward direction, 
because Java does not support class field forward references. 

Listing 8.4's Classlnitializer4 source code attempts to reference a subse- 
quently declared class field from the expression portion of a previously 
declared class field's class field initializer. 

Listing 8.4: Classlnitializer4. java 
// Classlnitializer4. java 




EXAMPLE 



class Classlnitializer4 
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Listing 8.4: continued 
{ 

static int classFieldl = 1 + classField2; 
static int classField2 = 1 ; 

public static void main (String [] args) 
{ 

System. out. println (classFieldl ) ; 

} 

} 

When the compiler encounters classField2 in classFieldl's class field ini- 
tializer, it reports an error concerning a forward reference attempt. Why is 
that a problem? If that code could be compiled and run, the JVM would 
assign 1 to classFieldl, not 2 as the developer probably intended. It would 
assign 1 to classFieldl because classField2 would contain zero at the time 
ClassFieldl's class field initializer executes. 

Although sufficient for the initialization of class fields, class field initializ- 
ers are inadequate for more complex class initialization. For example, sup- 
pose you need to read the contents of a file into a buffer before the main ( ) 
method executes. What do you do? Java meets that challenge by providing 
the class block initializer. A class block initializer consists of keyword 
static followed by an open brace character ({), initialization code, and a 
close brace character (}). Furthermore, a class block initializer appears 
within a class but not within any of that class's methods. When the com- 
piler encounters a class block initializer, it places the equivalent bj^ecode 
instructions in the class's <clinit> method. 

Listing 8.5's ClasslnitializerS source code introduces a class block initial- 
izer that extracts the name of the user's current timezone from a system 
property called user. timezone. The timezone, expressed as a String, assigns 
to a class field named tz. (You will learn more about system properties in 
Chapter 13.) 

Listing 8.5: ClasslnitializerS. Java 
// ClasslnitializerS. java 

class ClasslnitializerS 
{ 

static String tz; 

static 
{ 

java. util. Properties p = System. getProperties (); 
p. list (System. out) ; 
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Listing 8.5: continued 

tz = p.getProperty ( "user.timezone" ) ; 
if (tz. equals ("")) 
tz = "Default" ; 

} 

public static void main (String [] args) 
{ 

System. out. println ("timezone = " + tz); 

} 

} 

When you run ClasslnitializerS, the JVM first executes the default class 
initializer. Then, it executes the <clinit> method. Within that method, the 
JVM executes the bytecode instructions that obtain the user's timezone and 
assign an appropriate value to class field tz. Once the <clinit> method 
completes, the main() method starts to execute. And what does main() print, 
by way of its System, out .println ("timezone = " + tz) ; statement? It might 
print the word Default or some other word that identifies your timezone. 

ClasslnitializerS introduces a local variable declaration in its class block 
initializer. That variable is p, of type java.util. Properties. You should keep 
in mind that any variable you declare in a class block initializer is local to 
that block. No code outside the block can access the variable. As a result, 
you can access p only from its point of declaration to the end of its class 
block initializer. 



CAUTION 

Attempting to access a local variable from outside its class block initializer results in a 
compiler error. 

After studying ClasslnitializerS's class block initializer, you might be won- 
dering if class block initializers are all that useful? After all, it is easy to 
move all code from ClasslnitializerS's class block initializer to its main( ) 
method. My answer to you is that class block initializers are useful. For 
example. Sun's JDBC (Java Database Connectivity) API uses class block 
initializers to simplify database driver registration. Consider the following 
code fragment: 

Class. forName ( "sun. idbc.odbc.JdbcOdbcDriver" ) ; 

The code fragment calls Class's forName ( ) method to load the JdbcOdbcDriver 
class (located in the sun.jdbc.odbc package). Once that code fragment com- 
pletes, the class has loaded, and the database driver that associates with 
the JdbcOdbcDriver class has registered with JDBC. What causes that regis- 
tration to occur? The answer is JdbcOdbcDriver's class block initializer. Java 
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statements that comprise JdbcOdbcDriver's class block initializer perform 
the registration task. 

Any number of class field initializers and class block initializers can be 
interspersed throughout a class declaration. During compilation, the com- 
piler compiles each class initializer and places the resulting bytecode 
instructions in that class's <clinit> method, in a top-to-bottom order. 

To demonstrate the top-to-bottom initialization order of mixed class 
field and class block initializers, I've created an application called 
Classlnitializere. That application's source code appears in Listing 8.6. 

Listing 8.6: Classlnitializere. Java 
// Classlnitializere. java 

class Classlnitializere 
{ 

static int classField = 3; 

static 
{ 

System. out. println ("Block #1, classField = " + classField); 

ClassField = 1 ; 
for (int i = 2; i < e; i++) 
ClassField *= i; 

static 

System. out. println ("Block #2, classField = " + classField); 

public static void main (String [] args) 
System. out. println (classField); 

} 

When run, Classlnitializere produces the following output: 

Block #1 , ClassField = 3 
Block #2, ClassField = 120 
120 

Class constants (that is, final static variables) must be initialized before 
they are accessed. Typically, you perform that initialization via a class field 
initializer — for example, final static double PI = 3. 14159; . However, it is 
possible to defer initialization to a class block initializer. 
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^ \ I / Listing 8.7's Classlnitializer? source code demonstrates the deferral of a 
s V IB^ class constant's initialization to a class block initializer. 

l=* Listing 8.7: classlnitializer?. java 
// Classlnitializer?. java 

class Classlnitializer? 
{ 

final static int classField; 

static 
{ 

classField = 29; 

} 

public static void main (String [] args) 
{ 

System. out. println (classField); 

} 

} 

When run, Classlnitializer? produces the following output: 
29 



Instance Initializers 

OUTPUT You have just seen how class initializers initialize classes. To complement 

class initializers, Java offers instance initializers. Instance initializers focus 
on the initialization of objects (that is, class instances). The simplest kind of 
instance initialization is the JVM's automatic initialization of instance 
fields to default values, just after the JVM allocates memory for a new 
object's instance fields. That kind of instance initialization can be thought 
of as the default instance initializer. 

^ \ I / Listing 8.8's Instancelnitializerl source code demonstrates the default 
1 instance initializer initializing various instance fields to default values. 

Listing 8.8: instancelnitializerl . java 
// Instancelnitializerl .java 

class Instancelnitializerl 
{ 

boolean bool; 
byte by; 
char ch; 
double d; 
float f; 



EXAMPLE 
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Listing 8.8: continued 

int i; 
long 1; 
short sh; 
String str; 

public static void main (String [] args) 
{ 

Instancelnitializerl ii1 = new Instancelnitializerl (); 

System. out. println ("iil.bool = " + iil.bool); 
System. out. println ("iil.by = " + iil.by); 
System. out. println ("iil.ch = " + iil.ch); 
System. out. println ("ii1.d = " + ii1.d); 
System. out. println ("ii1.f = " + ii1.f); 
System. out. println ("ii1.i = " + ii1.i); 
System. out. println ("ii1.l = " + ii1.l); 
System. out. println ("iil.sh = " + iil.sh); 
System. out. println ("iil.str = " + iil.str); 

} 

} 

Instancelnitializerl mirrors Classlnitializerl by introducing a variety of 
fields. Unlike Classlnitializerl, however, the fields are not class fields. 
Instead, they are instance fields, because each instance of a class gets its 
own copy of those fields. Until instancelnitializerl iil = new 
Instancelnitializerl () ; executes, those fields do not exist. Once the afore- 
mentioned statement executes, the object referenced by iil has its own 
copy of those fields, initialized to default values. You see the following out- 
put when Instancelnitializerl runs: 

ii1 . bool = false 
ii1 .by = 0 
ii1 . ch = 
ii1 .d = 0.0 
ii1 .f = 0.0 
ii1 .i = 0 
ii1 .1 = 0 
ii1 .sh = 0 
ii1 . str = null 

The default instance initializer is responsible for zeroing the bits of all 
instance fields. However, unlike class fields, which the default class initial- 
izer zeroes after a class loads and verifies, the default instance initializer 
only zeroes the bits of a class's instance fields when a program creates an 
object from that class. 
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The next simplest kind of instance initialization is the explicit initialization 
of instance fields to values. Each instance field explicitly initializes to a 
value via an instance field initializer. As with a class field initializer, think 
of an instance field initializer as consisting of the simple assignment opera- 
tor followed by an expression whose value assigns to an instance field, as in 
double amount = 100.0;. 

^ \ I / Listing 8.9's Instancelnitializer2 source code extends the previous 

s rIBr instancelnitializerl source code by introducing several instance field ini- 

^ tializers that evaluate expressions and initialize their associated instance 

EXAMPLE fields to the results of those expression evaluations. 

Listing 8.9: Instancelnitializer2 . j ava 
// Instancelnitializer2.iava 

class Instancelnitializer2 
{ 

boolean bool = true; 
byte by = 20; 
char ch = 'X' ; 
double d = 8.95; 
float f = 2.1f; 
int i = 63; 
long 1 = 22L; 
short sh = 25000; 
String str = "test" ; 

public static void main (String [] args) 
{ 

Instancelnitializer2 ii2 = new Instancelnitializer2 (); 



System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 



'ii2.bool 
'ii2.by = 
'ii2.ch = 
'ii2.d = " 
'ii2.f = " 
'ii2.i = " 
'ii2.1 = " 
'ii2.sh = 
'ii2.str = 



-- " + ii2.bool) 
' + ii2.by) ; 
' + ii2.ch) ; 

+ ii2.d) 

+ ii2.f ) ; 

+ ii2.i) ; 

+ ii2.1) ; 
' + ii2.sh) ; 

" + ii2.str) ; 



In contrast to Instancelnitializerl, Instancelnitializer2 explicitly assigns 
a non-default value to each instance field by way of an instance field initial- 
izer. Instancelnitializerl produces the following output: 
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ii2.bool = true 
c^/.^ ii2.by = 20 
ii2.ch = X 

ii2.d = 8.95 

OUTPUT ii2.f = 2.1 

ii2.i = 63 
ii2.1 = 22 
ii2.sh = 25000 
ii2.str = test 



What is responsible for executing instance field initializers? The answer is 
a constructor. The compiler inserts bytecode instructions into a constructor 
that execute instance field initializers. However, only those constructors 
that explicitly or implicitly call superclass constructors receive those byte- 
code instructions. Constructors that call other constructors in the same 
class do not receive bytecode instructions that execute instance field 
initializers. 

Wait a minute! Instancelnitializer2 does not declare a constructor? That's 
true. However, in the absence of an explicitly declared constructor, the com- 
piler inserts a default no-argument constructor into a class. 

If you were to examine a constructor at the JVM level, you would see some- 
thing called <init> in place of that constructor. During the compilation of a 
class, the compiler generates an <init> method for each of that class's con- 
structors. If that class contains no constructors (which is the case in 
Instancelnitializer2), the compiler generates an <init> method that 
matches the default no-argument constructor. It is important to realize 
that each constructor has its own corresponding <init> method and that 
the compiler places bytecode instructions, apart from the instructions you 
specify (via Java source code), into that method. Some of those instructions 
serve to execute instance field initializers. To see what the bytecode instruc- 
tions for Instancelnitializer2's default no-argument <init> method look 
like, examine the following code fragment: 

0 aload_0 

1 invokespecial iava/lang/Obiect/<init>()V 

4 aload_0 

5 iconst_1 

6 putfield InstanceInitializer2/bool Z 
9 aload_0 

10 bipush 20 

12 putfield Instancelnitializer2/by B 

15 aload_0 

16 bipush 88 

18 putfield Instancelnitializer2/ch C 

21 aload 0 
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22 


ldc2_w #8.950000 


25 


putfield Instancelnitializer2/d D 


28 


aload_0 


29 


IdC #2.100000 


31 


putfield Instancelnitializer2/f F 


34 


aload_0 


35 


bipush 63 


37 


putfield Instancelnitializer2/i I 


40 


aload_0 


41 


ldc2_w #22 


44 


putfield Instancelnitializer2/1 J 


47 


aload_0 


48 


sipush 25000 


51 


putfield Instancelnitializer2/sh S 


54 


aload_0 


55 


Idc "test" 


57 


putfield Instancelnitializer2/str Ljava/lang/String; 


60 


return 



Apart from the code fragment's bytecode instructions executing 
Instancelnitializer2's instance field initializers, a close examination of the 
code fragment reveals some interesting items to note about how Java 
works: 

• The aload_0 instruction pushes an address (that is, an object refer- 
ence) onto a stack. And what address does that instruction push? The 
answer is the current object address — as represented by keyword this 
in source code. The invokespecial and putfield instructions pop that 
address from the stack and use the address to identify the proper 
object when making a call to an instance method 

or writing to an instance field, respectively. 

• The invokespecial j ava/lang/Obj ect/<init>( )V instruction calls the 
default no-argument constructor — to be precise, the default no- 
argument <init> method — in the Object superclass. (Remember 
keyword super's use in calling a superclass constructor? You are 
seeing how Java uses that keyword at the bytecode level.) 

• It is no accident that the compiler places invokespecial java/lang/ 
Obiect/<init>()V as the second instruction (after aload_0) in the 
default no-argument <init> method. The way Java works, a construc- 
tor must first either call another constructor in the same class or a 
constructor in its superclass. If a constructor does not explicitly call 
another constructor in the same class (via this) or a constructor in a 
superclass (via super), the compiler generates bytecode instructions 
that are the equivalent of placing super ( ) ; at the start of a con- 
structor. 
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As with class fields, some programs require instance fields to refer to previ- 
ously declared instance fields. Java supports that activity by allowing you 
to specify the name of a previously declared instance field in the expression 
portion of a subsequently declared instance fields's instance field initializer. 

It is possible to initialize an instance field using the value of a previously 
initialized instance field, as Listing 8.10 demonstrates. 

Listing 8.10: InstancelnitializerS. Java 

// InstancelnitializerS.java 



class InstancelnitializerS 
{ 

int instanceFieldl = 1 ; 

int instanceField2 = 1 + instanceFieldl ; 



OUTPUT 



EXAMPLE 



public static void main (String [] args) 
{ 

System. out. println (new InstancelnitializerS ( ) . instanceField2) ; 

} 



} 



After Instancelnitializens's default no-argument <init> method explicitly 
initializes instanceFieldl to 1, it uses that value to initialize instanceField2 
to 2. When run, Instancelnitializers produces the following output: 
2 

Just as you cannot use forward references with class field initializers, you 
cannot use forward references with instance field initializers. 

Listing 8.11's Instancelnitializer4 source code does not compile because 
instanceFieldl's instance field initializer attempts to access the subse- 
quently declared instanceField2. 

Listing 8.11: Instancelnitializer4. Java 
// Instancelnitializer4.iava 



class Instancelnitializer4 
{ 

int instanceFieldl = 1 + instanceField2; 
int instanceField2 = 1 ; 



public static void main (String [] args) 
{ 

System. out. println (new Instancelnitializer4 (). instanceFieldl ) ; 

} 
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When the compiler encounters instanceField2 in instanceFieldl's initiahzer, 
it reports an error concerning a forward reference attempt. 

Instance field initializers are sufficient for the initialization of instance 
fields. However, they are inadequate for more complex instance initializa- 
tion. To parallel class block initializers, Java supports the instance block 
initializer. An instance block initializer consists of an open brace character 
({), initialization code, and a close brace character (}). Furthermore, an 
instance block initializer appears within a class but not within any of that 
class's methods. When the compiler encounters an instance block initializer, 
it places equivalent bytecode instructions in all of the class's <init> meth- 
ods that either explicitly or implicitly call superclass <init> methods. Those 
bytecode instructions are not placed in <init> methods that call other 
<init> methods in the same class. 

Listing 8.12 presents source code to the instancelnitalizers application. 
That source code demonstrates an instance block initializer. 

Listing 8.12: Instancelnitializers. Java 
// InstancelnitializerS.java 

class InstancelnitializerS 
{ 

int instanceField; 
{ 

int he = hashCode ( ) ; 
instanceField = he; 

for (int i = 0; i < 32; i++) 
{ 

System. out. print ((he & 0x80000000) != 0 ? '1' : '0'); 
he «= 1 ; 

} 

System. out. println (""); 

} 

public static void main (String [] args) 
{ 

System. out. println (new InstancelnitializerS (). instanceField) ; 
System. out. println (new InstancelnitializerS (). instanceField) ; 

} 

} 




EXAMPLE 
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OUTPUT 




EXAMPLE 



When you run instancelnitializerS, the JVM creates a pair of 
instancelnitializerS objects. For each object, the JVM calls the default no- 
argument <init> method that corresponds to the default no-argument con- 
structor. The <init> method first calls Object's <init> method. When that 
method returns, Instancelnitializers's <init> method executes all bytecode 
instructions making up its sole instance block initializer. Run 
InstancelnitializerS, and you will see output similar to the following: 

0000000001 1 1 01 1 001 01 001 01 001 0001 
7754385 

00000000001 001 1 01 1 1 001 00001 1 0001 
2548785 

NOTE 

Your output might look slightly different because each object gets a unique hashcode, 
and hashcodes can vary between executions of a program. 

InstancelnitializerS introduces a local variable declaration in its instance 
block initializer. That variable is he, of type integer. You should keep in 
mind that any variable you declare in an instance block initializer is local 
to that block. No code outside the block can access the variable. As a result, 
you can access he only from its point of declaration to the end of its instance 
block initializer. 

CAUTION 

Attempting to access a local variable from outside its instance block initializer results 
in a compiler error. 

Any number of instance field initializers and instance block initializers can 
be interspersed throughout a class declaration. During compilation, the 
compiler compiles each instance initializer and places the resulting byte- 
code instructions in all <init> methods that call superclass <init> methods, 
in a top-to-bottom order. 

To demonstrate the top-to-bottom initialization order of mixed instance 
field and instance block initializers, I've created an application called 
Instancelnitializere. That application's source code appears in 
Listing 8.13. 

Listing 8.13: instancelnitializere. Java 
// Instancelnitializere. java 



class Instancelnitializere 
{ 

int instanceField; 
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OUTPUT 



Listing 8.13: continued 
{ 

System. out. println ("Block #1, instanceField = " + instanceField) ; 

int he = hashCode ( ) ; 
instanceField = he; 

for (int i = 0; i < 32; i++) 
{ 

System. out. print ((he & 0x80000000) !=0? '1' : '0'); 
he «= 1 ; 

} 

System. out. println (""); 

} 
{ 

System. out. println ("Bloek #2, instanceField = " + instanceField); 

} 

public static void main (String [] args) 
{ 

System. out. println (new Instancelnitializere (). instanceField) ; 
System. out. println (new Instancelnitializere (). instanceField) ; 

} 

} 

When run, Instancelnitializere produces the following output: 
Block #1 , instanceField = 0 

0000000001 1 1 01 1 001 01 001 01 001 0001 

Block #2, instanceField = 7754385 
7754385 

Block #1 , instanceField = 0 

00000000001 001 1 01 1 1 001 00001 1 0001 

Block #2, instanceField = 2548785 
2548785 

Instance constants (that is, final variables) must be initialized before they 
are accessed. Typically, you perform that initialization via an instance field 
initializer — for example, final int UP = 1 ;. However, it's possible to defer 
initialization to an instance block initializer. 
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^ \ I / Listing 8.14's Instancelnitializer/ source code demonstrates the deferral of 
1 r ISr instance constant's initialization to an instance block initializer. 

t^^^ Listing 8.14: instancelnitializer/. java 
// Instancelnitializer?. java 

class Instancelnitializer/ 
{ 

final int instanceField; 
{ 

instanceField = 25; 

} 

public static void main (String [] args) 
{ 

System. out. println (new Instancelnitializer? (). instanceField) ; 

} 

} 

When run, Instancelnitializer? produces the following output: 
25 



Mixing Class and Instance Initializers 

OUTPUT Classes can contain a mixture of class and instance initializers. When try- 
ing to figure out the order of initialization, keep in mind that class initializ- 
ers execute in a top-to-bottom order after the class loads and before any 
objects are created. Instance initializers execute only when an object is cre- 
ated (and in a top-to-bottom order). 

\ I / To get some practice at figuring out initializer order, check out the source 
s!/' Bf code to the Mixedlnitializer application in Listing 8.15. 

' * Listing 8.15: Mixedlnitializer. java 
// Mixedlnitializer. java 

class Mixedlnitializer 
{ 

int i1 ; 

static int 12; 
int 13 = 2; 



EXAMPLE 



Static int 14 = 4; 
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Listing 8.15: continued 
{ 

System. out. println ("i1 = " + i1 ) ; 

11 = 6; 

System. out. println ("i1 assigned 6"); 

} 

static 
{ 

System. out. println ("i2 = " + 12); 

12 = 8; 

System. out. println ("12 assigned 8"); 

} 



public static void main (String [] args) 
{ 

System. out. println ("main() entered"); 

Mixedlnitializer ml = new Mixedlnitializer (); 

System. out. println ("mi. 11 = " + ml. 11); 

System. out. println ("12 = " + 12); 

System. out. println ("mi. 13 = " + ml. 13); 

System. out. println ("14 = " + 14); 



System. out. println ("main() exited"); 
11 += 6; 

System. out. println ("6 added to 11"); 



static 
{ 

12 -= 3; 

System. out. println ("3 subtracted from 12") 

} 

} 
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When Mixedlnitializer runs, the following prints: 

i2 = 0 

i2 assigned 8 

3 subtracted from i2 

main() entered 

i1 = 0 

11 assigned 6 
6 added to i1 
mi.i1 = 12 

12 = 5 
mi.i3 = 2 
i4 = 4 

mainO exited 

Initializers and Inheritance 

We've looked at initializers as they apply to a class not derived from any 
class (apart from Object). However, you need to be aware of a couple of ini- 
tializer issues that arise when inheritance (from any other class) is 
involved. 

The first issue deals with initialization order, as Listing 8.16's 
Inheritancelnitializen source code demonstrates. 

Listing 8.16: inheritance initializer! . j ava 
// Inheritancelnitializerl . java 

class Parent 
{ 

int a = 5; 
int b; 

static double c = 2.0; 
static long d; 
{ 

System. out. println ("a 
System. out. println ("b 

} 

static 
{ 

System. out. println ("c = " + c); 
System. out. println ("d = " + d); 



= " + a); 
= " + b); 
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Listing 8.16: continued 
} 

} 

Class Child extends Parent 
{ 

int w; 

static int x = 2; 
double y = 3.5; 
static boolean z = true; 
{ 

System. out. println ("w 
System. out. println ("y 

} 



+ w); 

+ y); 



} 



static 
{ 

System. out. println ("x 
System. out. println ("z 

} 



+ X); 
+ z); 



class Inheritancelnitializen 
{ 

public static void main (String [] args) 
{ 

Child c = new Child ( ) ; 



System. out. println 
System. out. println 
System. out. println 
System. out. println 

System. out. println 
System. out. println 
System. out. println 
System. out. println 



'c.a = " + c.a) ; 
'c.b = " + c.b); 
'Parent. c = " + Parent. c) ; 
'Parent. d = " + Parent. d) ; 

'c.w = " + c.w) ; 

'Child. X = " + c.x) ; 

'c.y = " + c.y); 

'Child. z = " + c.z) ; 



Inheritancelnitializerl declares three classes: Inheritancelnitializerl , 
Parent, and Child. Furthermore, the Inheritancelnitializerl class's main() 
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method creates a Child object and displays the contents of various class and 
instance fields, as the following output illustrates: 

z = true 

OUTPUT a , 5 

b = 0 
w = 0 
y = 3.5 
c.a = 5 
c.b = 0 

Parent. c = 2.0 
Parent. d = 0 
c.w = 0 
Child. X = 2 
c.y = 3.5 
Child. z = true 

Take a close look at the output. It reveals the order in which 
Inheritancelnitializen initializes. We can break down that order 
as follows: 

• All class initializers execute before instance initializers. 

• Class initializers execute in a superclass to subclass order. That 
implies that the JVM always calls a superclass's <clinit> method 
before a subclass's <clinit> method. That process begins with the top 
<clinit> method in a class hierarchy and progresses down the hierar- 
chy until the lowest class's <clinit> method has executed. If a class 
does not have a <clinit> method, that class is skipped. As a result, 
when the class loader loads a class, it also loads all superclasses and 
performs top-down class initialization. For example. Parent's <clinit> 
method executes before Child's <clinit> method. (Object does not have 
a <clinit> method. If Object had such a method, that method would 
execute first.) 

To initialize an object, an <init> method corresponding to a constructor 
is called. The first thing <init> does is either call another <init> method 
in the current class or call one of its superclass's <init> methods. 

• If an <init> method A calls another <init> method B in the same class, 
<init> method A does not contain bytecode instructions that execute 
any instance initializers in <init> method As class. Java does not con- 
sider that necessary because the idea is for <init> method B to call a 
superclass <init> method and then execute instance initializers. 
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• If an <init> method A calls one of its superclass <init> methods, 
<init> method A contains bytecode instructions that execute any 
instance initializers in <init> method As class. Those instructions 
execute after the superclass's <init> method returns. For example, if 
you look at Inheritancelnitializerl's Child class, you will not see a 
constructor. However, the compiler generates a default no-argument 
constructor for Child, whose <init> method calls Parent's default no- 
argument <init> method. In turn. Parent's <init> method calls Object's 
default no-argument <init> method. Once Object's <init> method 
returns. Parent's <init> method executes all of its instance initializers 
and returns. Once Parent's <init> method returns. Child's <init> 
method executes all of its instance initializers and returns. The equiv- 
alent bytecode instructions to the first statement following Child c = 
new Child ( ) ; then execute. 

The second issue deals with accessing subclass fields from a superclass's 
<init> method. However, that isn't a good idea, because subclass fields 
aren't initialized until the superclass's <init> method completes. Listing 
8.17's Inheritancelnitializer2 source code demonstrates. 

Listing 8.17: inheritance I nit ializer2 . j ava 

// Inheritancelnitializer2. java 

class Parent 
{ 

Parent () 
{ 

System. out. println ("Parent: x = " + ((Child) this).getx ()); 
System. out. println ("Parent: y = " + ((Child) this).y); 

} 

} 

class Child extends Parent 
{ 

private int x = 5; 

int getx () 
{ 

return x; 

} 



int y = -2; 

} 
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Listing 8.17: continued 

class Inheritancelnitializer2 

{ 

public static void main (String [] args) 
{ 

Child c = new Child ( ) ; 

System. out. println ("x = " + c.getx () 
System. out. println ("y = " + c.y); 



OUTPUT 



} 

The following output shows that Child's x and y fields, when accessed from 
Parent, contain their default 0 values: 

Parent: x = 0 
Parent: y = 0 
X = 5 
y = -2 

CAUTION 

Avoid code that accesses subclass fields from a superclass constructor. Otherwise, the 
constructor might behave erratically. 



Garbage Collection 



Java programs create objects, by way of the new keyword. For each object, 
new allocates memory from a special JVM memory area (known as the heap) 
to hold that object's instance field values and internal housekeeping infor- 
mation (such as pointers to class field values and bytecode instructions for 
each of that object's methods). Each object's instance field values and inter- 
nal housekeeping information collectively form that object's memory image. 



NOTE 

Internally, Java uses pointers to refer to different parts of an object, but it does not 
allow developers to use that feature. The rationale is that pointers lead to security and 
robustness problems when improperly used. Furthermore, pointers violate portability. In 
place of pointers, developers are allowed to use the safer concept of references. The 
difference between pointers and references is that a pointer is always a memory 
address to a block of memory, and a reference is anything — even a memory address — 
that identifies an object. 

When an object is no longer needed, it must be destroyed so that its mem- 
ory image is freed and can be used by future objects. If a program continu- 
ously creates (but never frees) objects, more and more memory will be 
required to hold memory images. Despite an underlying platform's virtual 
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memory system, the JVM will eventually have to terminate the program 
and display an out-of-memory error message. The continual allocation of 
memory that is never freed is known as a memory leak. 

\ I / Can a memory leak happen in a Java program? Definitely. Check out the 
MemoryLeak application source code, in Listing 8.18, for proof 

Listing 8.18: MemoryLeak. java 
// MemoryLeak. java 

class List 
{ 

MemoryLeak mem; 
List next; 

} 

class MemoryLeak 
{ 

static List top; 

char [] memory = new char [100000]; 

public static void main (String [] args) 
{ 

for (int i = 0; i < 100000; i++) 
{ 

List temp = new List {) ; 
temp. mem = new MemoryLeak (); 
temp. next = top; 
top = temp; 

} 

} 

} 

MemoryLeak's main() method repeatedly creates List and MemoryLeak objects in 
a loop. 

TIP 

You might be interested to know that Java's standard class library includes a List 
class in its java.awt package and a List interface in its java.util package. 

Each MemoryLeak object allocates an array of 100,000 characters. (Array allo- 
cation, by way of the new keyword, is explored in a later chapter.) A refer- 
ence to the MemoryLeak object is stored in the List object's mem field. 
Furthermore, the List object is inserted into the top position of a singly 
linked list. If MemoryLeak runs to completion, at least 20 billion bytes of 
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memory are required, just to store the elements of all array instances. 
However, it is more likely that a JVM will terminate MemoryLeak and display 
an out-of-memory error message; if you don't see that message, try chang- 
ing both occurrences of 100,000 to some larger integer (such as 10,000,000). 

✓ To learn more about singly linked lists, see "Self-Referential Classes," p. 535. 

In languages like C++, developers are expected to free all memory that they 
dynamically allocate. However, it is possible that a developer will forget to 
free memory (leading to memory leaks), incorrectly free that memory (such 
as deleting an array pointer's memory block without first deleting each of 
the memory blocks pointed to by the array's elements), or attempt to free 
previously freed memory. Those scenarios undermine the integrity of a pro- 
gram and the underlying operating system. 

To preserve system integrity, Java does not allow objects to be explicitly 
freed. Instead, Java takes on that responsibility, by way of the JVM's 
garbage collection mechanism. When an object is no longer referenced, the 
garbage collector automatically reclaims that object's memory. As a result, 
the developer does not need to keep track of memory for the purpose of 
deletion. Furthermore, the developer is freed from the previously men- 
tioned C++ memory deletion problems (except for memory leaks). 

A garbage collector isn't used only to reclaim memory: It is also used to 
combat fragmentation of the heap. Heap fragmentation occurs when objects 
are created and unreferenced objects are freed, in such a way that blocks of 
available memory lie between memory occupied by referenced objects. 
Although there might be enough available heap memory to satisfy a new 
allocation request, the heap might need to be expanded if no single block of 
free heap memory exists that is large enough to hold a new object's memory 
image. On a virtual memory system, the extra paging requests required to 
support a growing heap can degrade system performance. Therefore, during 
garbage collection, the garbage collector moves memory around so that indi- 
vidual blocks of free memory are collapsed into a single contiguous free 
memory block. In other words, the garbage collector defragments the heap. 



NOTE 

According to Sun's JVM specification, it is not a requirement for a JVM implementation 
to contain a garbage collector. JVM designers are allowed to manage memory in any 
way they see fit. For example, a JVM running on a smart card (witli a tiny amount of 
memory) might require a program to completely fit into the smart card's memory. As a 
result, the smart-card JVM would not require a garbage collector. However, most JVMs 
do support some form of garbage collection. 
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The JVM specification also does not specify an algorithm for performing garbage collec- 
tion. JVM designers can choose any garbage-collection algorithm (such as mark and 
sweep) for their implementations. Because no specific algorithm is mandated, one 
never knows when garbage collection will be performed on an unreferenced object, 
which impacts finalization — discussed later in this chapter. 



Reachable and Unreachable Objects 

The garbage collector destroys an object and frees its memory when it 
determines that the object is no longer in use. An object is not in use when 
it cannot be reached through any reference. As long as there exists at least 
one reference to an object, that object is said to be reachable. When the last 
reference to that object disappears, the object is said to be unreachable and 
is eligible for garbage collection. 

To keep track of those objects that are reachable and those objects that 
become unreachable, Java identifies a root set of references that are imme- 
diately accessible to a program. Root set references include local variables, 
parameters, and class fields. All objects referenced from the root set of ref- 
erences are reachable by the program in its current state and are not eligi- 
ble for garbage collection. If those objects contain references to other 
objects, the other objects are considered reachable as well. Every heap 
object, apart from objects directly or indirectly reachable from root set ref- 
erences, is considered to be unreachable. Garbage collection algorithms 
identify reachable objects by starting with the root set of references and 
reclaim the memory occupied by unreachable objects. Figure 8.1 illustrates 
various reachable and unreachable objects. 




Figure 8.1: Reachable objects are referenced from root set references. All 
other objects are unreachable. 
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\ I / 
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Figure 8.1 shows two variables in the root set of references: c (of type Car) 
and d (of type d). The objects referenced by those variables are reachable. 
Furthermore, the object referenced by c contains a reference field, e (of type 
Engine), which references an Engine object. That object is also reachable 
because it can be reached (indirectly) from c. 

Figure 8.1 also shows various unreachable objects, including an unreach- 
able object that references a reachable object — the same D object referenced 
from variable d (in the root set of references). What does source code that 
creates the reachable and unreachable objects shown in Figure 8.1 look 
ike? The answer lies in Listing 8.19. 

isting 8.19: ReachableRef erencesDemo . j ava 
/ ReachableReferencesDemo.java 

lass Car 

private Engine e = new Engine (); 



lass Engine 
lass A 

private B b = new B (this); 

class B 

private C c; 



B (A a) 
{ 

c = new C (a) ; 

} 



} 



class C 
{ 

private A a; 



C (A a) 
{ 

this. a = a; 
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Listing 8.19: continued 
} 

} 

Class D 

{ 

} 

class E 
{ 

private D d; 

E (D d) 
{ 

this.d = d; 

} 



class ReachableRef erencesDemo 
{ 

public static void main (String [] args) 
{ 

Car c = new Car ( ) ; 

new Car ( ) ; 

new A ( ) ; 

D d = new D ( ) ; 

new E ; 

// At this point, only the first Car object (referenced by c) 
// and the D object (referenced by d) are reachable. 

} 

} 



TIP 

Java's Reference Objects API allows you to create softly, weakly, and phantomly reach- 
able objects. Those objects give your code limited interaction with the garbage collector. 
To learn more about the Reference Objects API, check out the article Reference 
Objects and Garbage Collection (http://developer.java.sun.com/developer/ 
technicalArticles/ALT/Ref Obj /). 
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Furthermore, for an article that demonstrates the use of the Reference Objects API in 
avoiding Swing MVC memory leaks, check out the JavaWorld article Java Tip 79: 
Interact with Garbage Collector to Avoid Memory Leaks (http: / /www. j avaworld . 
com/ j avatips / j w - j avatip79 . html). 



Running the Garbage Collector 

If a JVM has a garbage collector, that garbage collector normally runs as a 
low-priority thread. The idea is for garbage collection to be performed when 
a program isn't doing anything else (so that a program's performance is 
minimally impacted). Although you don't know when the garbage collector 
will run, you can influence the JVM to run the garbage collector — by calling 
System.gc( ). 

TIP 

Before entering a compute-intensive section of code (that is, a long-running series of 
calculations), especially in a long-running program (such as a Web server or a Web 
browser), you might want to call System. gc( ) to ensure that every effort has been 
made to destroy unreachable objects and defragment memory. 

According to the SDK documentation. System's gc( ) class method expends 
every effort to recycle unreferenced objects (that is, reclaim their memory). 
When gc ( ) returns, the JVM will have made a best effort to reclaim mem- 
ory occupied by unreferenced objects — and defragment the heap. 

NOTE 

In addition to System, the Runtime class also declares gc(). However, an object must 
be created from Runtime before gc( ) can be called. Therefore, it is more convenient to 
call gc 0 , by way of System. 



Finalization 



As an object evolves over its life, it can acquire various finite resources 
(such as file handles, sockets, graphics contexts, a sound card, and a ren- 
dering engine). After an object reaches the end of its life, it must release all 
acquired resources. If those resources aren't released, further attempts to 
acquire them will (eventually) fail. 

Resources are normally acquired in an object's constructor and released in a 
destructor (for C++). Because Java does not support destructors, some other 
mechanism is needed to release those resources. One such mechanism 
obtains and releases a resource within the same method. For example, a 
method might open a file, perform some file I/O, and then close that file. 
Although that mechanism ensures that a resource (the file handle) has 
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been released before the method exits, it can be inefficient: The file must be 
opened each time the method is called. The second mechanism involves 
acquiring the resource in one method and releasing the resource in a differ- 
ent method. As a result, the same object can acquire and release a resource 
multiple times, if desired. The final mechanism involves acquiring a 
resource in an object's constructor and providing a method that must be 
called to release that resource. Unlike the second mechanism, the resource 
can be acquired only once by the third mechanism. 

NOTE 

Both the second and the third mechanisms are commonly used (in the standard class 
library) for resource acquisition and cleanup. 

A problem with the second and third mechanisms is that a cleanup method 
might not be called, leading to a resource leak. That leak is either due to 
the absence of a cleanup method call (at an appropriate point in a program) 
or due to the cleanup method not being called when an exception occurs. 
Although developers should ensure that cleanup methods are called (even 
when exceptions occur), that is sometimes difficult to achieve, which is the 
rationale for Java's support of the finalization concept. 

✓ To learn more about exceptions, see "What Are Exceptions?" p. 334. 

Finalization involves the garbage collector calling an object's finalize () 
method before an object's memory is reclaimed. Code can be placed in the 
finalize 0 method to release the object's resources. Because Object 
declares finalize (), every object inherits (and can override) that method. 
The finalize 0 method is commonly referred to as a finalizer. 

The finalize 0 method can be declared with a Throws clause, which lists 
those exceptions that a finalize () method can throw. However, the garbage 
collector ignores all thrown exceptions. 

✓ To learn more about Throws clauses and throwing exceptions, see "Throwing Exceptions," 
p. 342. 

By the way, you can declare finalize ( ) as either a protected or a public 
method, but not private or package — in the absence of an accessibility 
keyword — because an overridden method's access level cannot be made 
more restrictive. 
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EXAMPLE 



\ I / To get a sense of how finalize ( ) is declared and works, check out the 
01 source code to the FinalizeDemo appHcation in Listing 8.20. 

Listing 8.20: FinalizeDemo . j ava 
// FinalizeDemo. Java 

class FinalizeDemo 
{ 

private static int id; 

private int myld; 

FinalizeDemo () 
{ 

myld = id++; 

System. out. println ("Created object #" + myld); 

} 

protected void finalize () throws Throwable 
{ 

System. out. println ("Finalized object #" + myld); 
super. finalize (); 

} 

public static void main (String [] args) 
{ 

FinalizeDemo fd; 
for (int i = 0; i < 10000; i++) 
fd = new FinalizeDemo (); 

} 

} 

FinalizeDemo creates 10,000 FinalizeDemo objects. Each object is given a 
unique identifier in the FinalizeDemo () constructor, which also prints that 
identifier as part of a message. At some point, because each new 
FinalizeDemo object results in the preceding FinalizeDemo object becoming 
unreachable (because the reference stored in f d is overwritten), the garbage 
collector (when it runs) will call that object's finalize ( ) method. When 
finalize ( ) is called, it will print a message that identifies the object being 
finalized. The super. finalize() call that's placed at the end of finalize () is 
important. That gives a superclass layer a chance to perform finalization. 
Without super. finalize 0, there is no way for the superclass to finalize 
itself 
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TIP 

Do not forget to place a super. finalize( ) method call in a finalize ( ) method, even 
if a class has no superclass (other than Object). At some future point, you might intro- 
duce a superclass for that class, and the superclass might require finalization. If you 
haven't placed super.f inalize( ) in the subclass's finalize () method and you 
create a subclass object, the superclass's finalize () method will never be called. 

Where should you place super. finalizeO? Because a superclass layer is initialized 
before a subclass layer, consider finalizing in reverse. That is, finalize a subclass layer 
before a superclass layer, by placing super.f inalize( ) at the end of finalize () . 



The following (partial) output of a sample FinalizeDemo run shows finaliza- 



OUTPUT 



tion at work: 




Finalized 


object 


#442 


Finalized 


object 


#443 


Finalized 


object 


#444 


Finalized 


object 


#445 


Finalized 


object 


#446 


Finalized 


object 


#447 


Finalized 


object 


#448 


Finalized 


object 


#449 


Finalized 


object 


#450 


Finalized 


object 


#451 


Finalized 


object 


#452 



There are two important points to remember about finalizers. First, there is 
no guarantee as to the order in which finalizers will be called. For example, 
in the preceding output, object #443 could be finalized before object #442. 
Second, there is no guarantee that a finalizer will be called. For example, 
just before a program exits, there might be several heap objects whose 
finalizeO methods have not been called. The JVM specification does not 
obligate a JVM implementation to ensure that finalizeO is called for each 
of those objects. 



CAUTION 

Don't depend on the order in which finalizers are called. Although they might appear to 
be called sequentially by one JVM, another JVM might call finalizers concurrently, or in 
nonsequential order. 

Also, don't depend on finalizers as a means of resource cleanup. Instead, think of a 
finalizer as a fallback cleanup mechanism. In other words, if an object's cleanup 
method hasn't been called, and if the object's finalizer is called, cleanup code placed in 
finalizeO will execute. That is about the extent of a finalizer's usefulness. 
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Running Finalizers 

Before a program exits, you can ask the JVM to run finalizers, by calling 
System. runFinalization( ). According to the SDK documentation. System's 
runFinalization( ) class method expends every effort to run the finalizers of 
discarded objects. When runFinalization( ) returns, the JVM will have 
made its best effort to run all outstanding finalizers. 



NOTE 

In addition to System, tine Runtime class also declares runPinalization ( ) . However, 
an object must be created from Runtime before runPinalization { ) can be called. 
Therefore, it is more convenient to call runPinalization { ) , by way of System. 



EXAMPLE 



Resurrection 

Some developers like to recycle the same objects. For example, a program 
might require an object pool from which objects are drawn. When an object 
is no longer needed, the idea is to return the object to the pool instead of 
destroying the object. That technique works by storing the current object's 
reference, during the finalize ( ) method call, in an object pool data struc- 
ture. When that happens, the garbage collector will not destroy the object, 
even though finalize ( ) has been called. That technique is known as resur- 
rection. 

\ I / To see resurrection in action, examine the source code to the 
01 ResurrectionDemo application in Listing 8.21. 

Listing 8.21: ResurrectionDemo . j ava 
// ResurrectionDemo. java 

class ResurrectionDemo 
{ 

private static int id; 
private int myld; 

private static ResurrectionDemo rd; 

ResurrectionDemo () 
{ 

myld = id++; 

System. out. println ("Created object #" + myld); 

} 



protected void finalize () throws Throwable 
{ 
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Listing 8.21: continued 

System. out. println ("Finalized object #" + myld); 
super. finalize (); 

rd = this; 

} 

public static void main (String [] args) 
{ 

new ResurrectionDemo (); 
System. gc (); 

System. runFinalization (); 

System. out. println (rd); 

rd = null; 
System. gc (); 

System. runFinalization (); 

} 

} 

ResurrectionDemo's mainO method creates an unreachable ResurrectionDemo 
object and then calls System. gc( ), followed by System. runFinalization( ), to 
make every attempt to run the garbage collector and the ResurrectionDemo 
finalizer. The finalize () method resurrects the current ResurrectionDemo 
object, by assigning this to root set reference rd. Later, rd is assigned null; 
then System. gc( ), followed by System. runFinalization( ), is called a second 
time. This time, the finalizer is not run. The reason is that the garbage col- 
lector calls f inalize( )only once. If an object is resurrected and then made 
eligible for garbage collection, finalize ( ) will not be called a second time. 



CAUTION 

When tested using the Windows version of the Java 2 SDK's JVM, ResurrectionDemo's 
finalizer ran after calls to System . gc () and System . runFinalization ( ) . However, 
there are no guarantees that a finalizer will always be called, in that manner, under any 
JVM. 

By the way, it is not a good idea to use resurrection, even when that technique is tempt- 
ing. Using resurrection obscures source code and makes reading that code more diffi- 
cult for others. Consider cloning objects or using the Reference Objects API instead of 
resurrection. 
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Nested Classes 



The Java language makes it possible to nest classes within other classes, 
within blocks, or (anonjnnously) within an expression. Java supports that 
feature to simplify class relationships. For example, a data structure class 
might contain its own iterator class. Nested classes make it easier for the 
Java developer to connect objects to each other, because classes can be 
declared closer to the objects they must manipulate and can directly use 
the names they need. 



TIP 

It is also possible to nest interfaces within classes. 



A tangible benefit of nesting a class in another class is a reduction of name 
conflicts in a namespace. For example, suppose your program calls for two 
independent classes named A and B. Furthermore, suppose you discover a 
class B that is related to A. It is impossible to introduce A, B, and B in the 
same source file because you cannot introduce two classes named B at the 
same level. Instead, by declaring the class B that is related to A in A, you 
end up with A, B, and a$b (where the $ character identifies B as a class con- 
tained in a). Those three classes can coexist in the same namespace. Java 
distinguishes nested classes as either top-level classes or inner classes. 

Top-Level Classes 

Any non-nested class is known as a top-level class. Furthermore, a nested 
class declared with the static keyword is also known as a top-level class. 
Nested top-level classes can access all static members of enclosing classes, 
even if those members are private. The TopLevelClassesDemo application in 
Listing 8.22 provides a demonstration. 

Listing 8.22: TopLevelClassesDemo . ] ava 
// TopLevelClassesDemo.] ava 

class TopLevelClassesDemo 
{ 

public static void main (String [] args) 
{ 

TopLevelClass tic = new TopLevelClass (); 

TopLevelClass . NestedTopLevelClass ntlc ; 

ntlc = new TopLevelClass. NestedTopLevelClass (); 

} 

} 




EXAMPLE 
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Listing 8.22: continued 
class TopLevelClass 
{ 

private int i; 

private static String name = "TopLevelClass"; 
{ 

System. out. println ("Assigning 1 to i"); 
i = 1; 

} 

static class NestedTopLevelClass 
{ 

int i; 
{ 

System. out. println ("Assigning 2 to ]"); 
i = 2; 

// System. out. println ("i = " + i); 

System. out. println (name); 

} 

} 

} 

When run, TopLevelClassesDemo produces the following output: 




Assigning 1 to i 
Assigning 2 to j 
TopLevelClass 



OUTPUT The main( ) method creates an instance of TopLevelClass, followed by an 

instance of NestedTopLevelClass. Note the different syntax used when creat- 
ing an instance of a nested top-level class. That syntax consists of the 
enclosing class's name, followed by a period character, followed by the 
nested top-level class's name. In general terms, if C is nested in B, which is 
nested in A, you refer to C in a class instance creation expression by specify- 
ing A. B.C. 

Don't be confused by the presence of static in the declaration of 
NestedTopLevelClass. That keyword does not prevent objects from being 
created. Instead, it prevents access to instance members of an enclosing 
class. That is why System. out. println ("i = " + i ); is commented out. 
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CAUTION 

A nested top-level class can access only static fields and methods in its enclosing 
class (or classes). An attempt to access an instance member results in a compiler 
error. 



Inner Classes 

Inner classes are similar to nested top-level classes because you can also 
declare inner classes in other classes. However, unlike nested top-level 
classes, inner classes can access both class and instance members of enclos- 
ing classes. Furthermore, an inner class declaration is not restricted to a 
class: Inner classes can also be declared in blocks and (anonymously) in 
class instance creation expressions. 

TIP 

The concept of inner (and other nested) classes debuted in Sun's JDK 1.1 release. 
Concomitant with that JDK release was Sun's Inner Classes Specification. For a thor- 
ough treatment of Sun's inner classes language feature, consider reviewing that 
specification, located at http: / / java. sun . com/products/ jdk/1 . 1 / docs /guide/ 
innerclasses/. 




EXAMPLE 



Instance Inner Classes 

A class declared in another class without the static keyword is known as 
an instance inner class. Instance inner classes can access both the instance 
and class members of enclosing classes. The instancelnnerClassDemo applica- 
tion in Listing 8.23 demonstrates that. 

Listing 8.23: InstancelnnerClassDemo. java 

// InstancelnnerClassDemo. java 

class InstancelnnerClassDemo 
{ 

public static void main (String [] args) 
{ 

TopLevelClass tic = new lopLevelClass (); 
TopLevelClass. InstancelnnerClass iic; 
// iic = new TopLevelClass . InstancelnnerClass (); 



} 



} 



iic = tic. new InstancelnnerClass (); 
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Listing 8.23: continued 
class TopLevelClass 
{ 

private int i = 3; 

private static String name = "TopLevelClass"; 

class InstancelnnerClass 
{ 

int i; 
{ 

System. out. println ("Assigning 2 to ]"); 
j = 2; 

System. out. println ("i = " + i); 
System. out. println (name); 

} 

} 

} 

When run, instancelnnerClassDemo produces the following output: 
Assigning 2 to j 
i = 3 

TopLevelClass 



OUTPUT The syntax of the instance inner class's class instance creation expression 
differs from the nested top-level class instance creation expression syntax, 
in the following way: When an object is being created from a nested top- 
level class, new is followed by the name of each enclosing class (separated 
from each other with period characters). The name of the nested top-level 
class being created follows the final period. Here's an example: ntlc = new 
TopLevelClass . NestedTopLevelClass ( ) ; . In contrast, when an object is being 
created from an instance inner class, the name of the outer class object (fol- 
lowed by a period character) is prefixed to new, and the name of the 
instance inner class follows new. Here's an example of that: iic = tic. new 
InstancelnnerClass ( ) ;. It might be tempting to follow the same syntax as 
that used to create an object from a nested top-level class, as the commented- 
out line indicates, but that would be a mistake. 

Local Inner Classes 

Sometimes, it is more convenient to declare a class close to code placed in a 
block. Java supports that concept by way of local inner classes. When a 
class is declared local to a block, it may access any name that is available to 
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EXAMPLE 



that block's expressions. To see how classes can be declared in blocks, exam- 
ine the LocallnnerClassDemo application source code in Listing 8.24. 

Listing 8.24: LocallnnerClassDemo. java 

// LocallnnerClassDemo. java 

interface Iteration 
{ 

public boolean hasMoreElements (); 
public String nextElement (); 

} 



class Employee 
{ 

private String name; 

Employee (String name) 
{ 

this. name = name; 

} 

public String toString () 
{ 

return name; 

} 

} 



class LocallnnerClassDemo 
{ 

public static void main (String [] args) 
{ 

String [] planetNames = 
{ 

"Mercury" , 
"Venus" , 
"Earth", 
"Mars" , 
"Jupiter" , 
"Saturn" , 
"Uranus" , 
"Neptune" , 
"Pluto" 

}; 



Employee [] employees = 
{ 



10 71710_CH08 11/21/01 12:52 PM Page 322 




322 Chapter 8: Initializers and Nested Classes 



Listing 8.24: continued 

new Employee ("John Doe"), 
new Employee ("Jane Smith"), 
new Employee ("Alex Donaldson") 

}; 

for (int j = 0; i < 2; ]++) 
{ 

Iteration i = mylterator ((j == 0) ? (Object []) planetNames 

: (Object []) employees); 

while (i. hasMoreElements ()) 
{ 

String s = (String) i.nextElement (); 
System. out. println (s); 

} 



System. out. println (""); 



} 

} 



static Iteration mylterator (final Object [] someArray) 
{ 

class LocallnnerClass implements Iteration 
{ 

// Instead of defaulting count to 0, make this explicit to 
// enhance source code readability. 

private int count = 0; 

public boolean hasMoreElements () 
{ 

return count < someArray. length; 

} 

public String nextElement () 
{ 

return someArray [count++] .toString (); 

} 

} 

return new LocallnnerClass {); 



10 71710_CH08 11/21/01 12:52 PM Page 323 




Nested Classes 323 



When run, LocallnnerClassDemo produces the following output: 
Mercury 
Venus 
Earth 

Mars 

°"TPUT j.piter 
Saturn 
Uranus 
Neptune 
Pluto 



John Doe 
Jane Smith 
Alex Donaldson 

LocallnnerClassesDemo demonstrates a LocallnnerClass class that's declared 
in a mylterator( ) class method. Notice that mylterator is declared to return 
an object whose class implements the iteration interface — a specialized 
version of the standard class library's Enumeration interface. LocallnnerClass 
also implements Iteration. As a result, it is legal to return a 
LocallnnerClass object from myIterator( ). 

As if that isn't unusual enough, notice that LocallnnerClass has access to 
mylterator( )'s someArray parameter. Furthermore, that parameter is 
declared final. What's happening? If either a local variable or a parameter 
is accessed by code within a local inner class (or an anonymous inner class), 
that variable must be declared final. The reason is that there is no way (by 
design) for two objects to share access to a changeable local variable (or 
parameter). In other words, if two threads were to simultaneously refer to a 
nonfinal local variable/parameter, the variable's value could be corrupted. 
After mylterator( ) returns, the someArray parameter is still accessible to 
LocallnnerClass. That behavior is contrary to the expected destruction of a 
parameter when a method returns, but it is necessary because objects cre- 
ated from local inner classes might still need to refer to those parameters 
(or local variables) after the method in which they are created ends. 



NOTE 

Inheritance and scope can become confusing wlien you're dealing with local inner 
classes. For example, suppose that Iteration declares a someArray constant (as in 
final static Object [] someArray = { "" };). That constant, when inherited by 
LocallnnerClass, hides the same-named someArray parameter in the enclosing 
scope. To prevent ambiguity, Java decrees that the name of the inherited someArray 
constant is allowed to hide the someArray parameter name. However, this, must 
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prefix each occurrence of someArray in LocallnnerClass. Otiien/vise, the code will not 
compile. However, when this, has been prefixed to each someArray occurrence, and 
the code has been compiled and run, it is the values of the someArray constant — and 
not the someArray argument passed to mylterator — that will be used by 
LocallnnerClass. 




EXAMPLE 



Anonymous Inner Classes 

For short local inner classes (consisting of few lines of code), going to all the 
trouble of selecting a class name is a bother. The name doesn't really con- 
tribute additional information to whoever maintains the source code (con- 
taining that class). To be more concise, you can take advantage of 
anonjnnous inner classes (that is, classes without names). 

Anonymous inner classes, although a little disconcerting when first encoun- 
tered, are convenient and not that difficult to work with. And, because you 
don't have to supply a class name for an anonymous inner class, the likeli- 
hood of name conflicts with other inner class names is reduced. 

The AnonymouslnnerClassDemol application source code in Listing 8.25 
demonstrates an anonymous inner class. 

Listing 8.25: AnonymouslnnerClassDemol . j ava 
// AnonymouslnnerClassDemol . java 

class AnonymouslnnerClassDemol 
{ 

public static void main (String [] args) 
{ 

new Dog () .talk ( ) ; 

new Animal ( ) 
{ 

void talk () 
{ 

System. out. println {"Meow!"); 

} 

}.talk 0; 



} 



} 



abstract class Animal 
{ 

abstract void talk ( ) ; 

} 
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Listing 8.25: continued 
class Dog extends Animal 
{ 

void talk () 
{ 

System. out. println ("Bark!"); 

} 

} 

AnonymouslnnerClassDemol produces the following output, when run: 

Bark! 
Meow! 



AnonymouslnnerClassDemol demonstrates two things. First, we went to a lot of 
OUTPUT trouble to create a Dog class that inherits from Animal. We also created a Dog 
object so that its inherited talk( ) method could be called. Second, we 
decided that we needed a Cat object. Rather than explicitly create a Cat 
class, we implicitly declared that class anonymously, implemented Animal's 
abstract talk( ) method in our anonymous class, and called that method. (It 
might look like we created an object from the abstract Animal class, but we 
did not. After all, objects cannot be created from abstract classes. Instead, 
we created an object from an anonymous subclass of Animal.) 

AnonymouslnnerClassDemol shows that anonymous inner classes can be cre- 
ated as subclasses of other classes. However, it is also possible to create 
anonjnnous inner classes that implement specific interfaces. Furthermore, 
we can take advantage of instance initializers to initialize objects created 
from those anonymous classes. 

NOTE 

Anonymous inner classes cannot liave constructors, so tine only way to initialize them is 
to use instance initializers. That is one area where a compiled class's <init> method 
does not correspond to a constructor 

The AnonymouslnnerClassDemo2 application source code in Listing 8.26 
demonstrates an anonymous inner class that implements an interface and 
also uses an instance initializer to initialize objects. 

Listing 8.26: AnonymousInnerClassDenio2. Java 
// AnonymousInnerClassDemo2. java 

class AnonymousInnerClassDemo2 
{ 

public static void main (final String [] args) 
{ 

TalkloMe ttm = new TalkToMe {) 




EXAMPLE 
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Listing 8.26: continued 

{ 

private String msg = "Talking"; 
{ 

if (args. length == 1 ) 
msg = args [0] ; 

} 

public void talk () 
{ 

System. out. println (msg); 

} 

}; 

ttm.talk 0; 

} 

} 

interface TalkToMe 
{ 

public void talk ( ) ; 

} 

AnonymouslnnerClassDemo2 produces the following output: 

Talking 

AnonymouslnnerClassDemo2's class instance creation expression reads as fol- 
lows: Create an object from an anonymous inner class that implements the 
TalkToMe interface. During object creation, the instance initializer runs, 
which might assign an argument to msg — if an argument is passed on the 
command line. For example, type java AnonymouslnnerClassDemo2 "Hello 
World" and see what happens. 

NOTE 

Anonymous inner classes are typically used by the Abstract Windowing Toolkit when 
working with event adapters. 




What's Next? 



During this chapter's exploration of finalization, the exceptions feature was 
mentioned. What are exceptions, and how are they dealt with? Tune in to 
the next chapter for answers. 
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Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 

NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 




Reviewing it 



One way to improve your understanding of the current chapter is to answer 
REVIEW ^ review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. Suppose you have a class named iterator that's declared in a class 
named Spreadsheet. What name does the compiler give to the class file 
containing Iterator? 

2. How does the mark and sweep garbage collector algorithm work? 
(Hint: You will need to do some research.) 

3. Why can't either a local inner class or an anonymous inner class 
access nonfinal parameters or local variables in the immediately 
enclosing scope? 



Clieci^ing it 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. Which nested class is declared with the static keyword? 

a. Anonymous inner class 

b. Nested top-level class 

c. Local inner class 

d. Instance inner class 
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2. Which of the following statements is true? 

a. Forward references from class fields to other class fields, in the 
same class, are illegal. 

b. Variables declared in one instance block initializer can be 
accessed from another instance block initializer in the same 
class. 

c. Both of the above 

d. Neither of the above 

3. Which of the following statements is false? 

a. Class constants and instance constants can have their initializa- 
tions deferred to class block initializers and instance block ini- 
tializers, respectively. 

b. A superclass constructor that accesses subclass fields retrieves 
their default values. 

c. Memory leaks cannot happen in Java. 

d. Both a and c 

4. Which is not a task performed by a garbage collector? 

a. Defragment the heap 

b. Reclaim memory 

c. Run a finalizer 

d. Expand the heap's size 

5. What level of reachability requires a reference queue? (Hint: You will 
need to read the article. Reference Objects and Garbage 
Collection, at http://developer.java.sun.com/developer/ 
technicalArticles/ALT/RefOb] / to answer this question.) 

a. Strong 

b. Soft 

c. Phantom 

d. Weak 

6. Which resource acquisition/release mechanism is not supported by 
Java? 



a. Acquire in a constructor and release in a nonconstructor method 

b. Acquire in a method and release in a different method 
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c. Acquire and release in the same method 

d. Acquire in a constructor and release in a destructor 

7. Which finalizer fact is false? 

a. supen.f inalize( ) should be placed in a finalize ( ) method. 

b. Finalizers can throw exceptions. 

c. Finalizers are called in a specific order. 

d. Every object has a finalizer. 

8. Nested top-level classes can access what? 

a. Class members 

b. Instance members 

c. Final local variables 

d. Both a and c 

9. What kind of inner class can be declared in a class instance creation 
expression? 

a. Instance inner class 

b. Anonymous inner class 

c. Local inner class 

d. All the above 

10. Which initializer fact is false? 

a. Class initializers initialize class fields. 

b. Instance initializers execute after a class loads and has been ver- 
ified and before an object is created. 

c. Instance initializers execute in a top-to-bottom order. 

d. An instance block initializer begins with an open brace, ends 
with a close brace, and is declared outside of any methods. 

True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. A local inner class can access nonfinal parameters and local variables 
in its immediately enclosing scope. 

True/False 
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2. Bytecode instructions corresponding to class field initializers and code 
in class block initializers are placed into a <clinit> method for that 
class. 

True/False 

3. There is no guarantee that a finalizer will be called. 
True/False 

4. An anonymous inner class can be a subclass of an interface. 
True/False 

5. Instance fields are not part of the root set of references. 
True/False 

6. Every <init> method corresponds to a constructor. 
True/False 

7. A resurrected object's finalizer is called after the object becomes eligi- 
ble for garbage collection (again). 

True/False 

8. Except for <init> methods that call other <init> methods in the same 
class, the compiler places bytecode instructions that correspond to 
instance field initializers and instance block initializers in each <init> 
method. 

True/False 

9. The first thing every <init> method does is call its superclass's <init> 
method. 

True/False 

10. The JVM initializes a class hierarchy's class fields by starting with the 
bottom class's class fields and working its way to the top class. 

True/False 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. Write a FileOpenClose class with a constructor for opening files and a 
method for closing files. Include a finalizer for performing fallback file 
closing. Of course, you won't be inserting any file open/close code. Just 
add comments, where relevant. 
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2. Write an initOrder application that uses initializers and inheritance to 
achieve the following output: 

parent: j = 2 
child: b = 20 
parent: i = 3 
child: a = 10 

3. Create an AnonymousDemo application consisting of Base and 
AnonymousDemo top-level classes. The Base class declares only a single 
instance field: String a = "Fred" ;. AnonymousDemo's main () method must 
create an object from an anonymous subclass of Base so that the fol- 
lowing prints: 

Barney 
Fred 
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Exceptions and Exception Handlers 

All programs can fail at times. The causes vary from programming mis- 
takes, to user error, to hardware faults or operating system mistakes. As a 
developer, part of your job is to create programs that handle failure prop- 
erly. After all, why should users pay for software that terminates at the 
first sign of failure, causing unsaved data to be lost? You can guard against 
failure by taking advantage of Java's exception-handling mechanism. That 
mechanism, if used properly, can help you write robust code. What are 
exceptions? This chapter answers that question and shows you how to 
handle them in your programs. 
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What Are Exceptions? 



A user inserts a floppy diskette into a disk drive and launches a file copy 
program that copies information to that diskette. During the copy, the user 
accidentally removes the diskette from the drive. Another user runs a pro- 
gram that attempts to access an array element with an invalid index. The 
first program fails because it cannot acquire a resource (the diskette), 
whereas the second program fails because of flawed code. Those failures 
occur when execution diverges from its normal flow, and that divergence is 
known as an exception. 

From Error Codes to Objects 

When an exception occurs, a program needs to handle the exception so that 
its execution can continue normally. Prior to 1990, exceptions were typically 
handled by testing integer values that functions would return. Usually, a 
zero value indicated success, and a negative value indicated some kind of 
exception. Those values became known as error codes. It didn't take long to 
discover three problems with error code testing: Error codes are often 
ignored; error code testing obscures the natural flow of execution (from a 
source code perspective); and error code testing increases program size. 

Error codes are often ignored. Consider the C language's fopen( ) function. 
That function is responsible for opening a file. It returns a result that is 
either the address of some data structure containing information on the 
newly opened file or a null value that indicates an exception. To open a 
binary file in read-only mode, a developer might write f p = f open 
( "somef ile" , "rb"); if (fp == NULL) { printf ("Error\n"); return; }. 
However, some developers don't bother to test for null. Their programs 
ignore that error code and continue, which normally results in additional 
exceptions. For example, ignoring fopen( )'s error code leads to subsequent 
f readO and f write () functions returning error codes that indicate a "file 
not open" exception. 

Error code testing obscures the natural flow of execution. Trjdng to trace 
through a program's source code is complicated by all the error-handling 
logic. Listing 9.1 demonstrates that obscurity (to a small extent) by way of 
source code to a C-based file copy program. 

Listing 9.1: fee. 
// fee 

#include <stdio.h> 

void main (int argc, char *argv []) 
{ 
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Listing 9.1: continued 

FILE *fpSrc, *fpDst; 
int byte; 

if (argc != 3) 
{ 

printf ("usage: fc srcfile dstfile"); 
return; 

} 

fpSrc = fopen (argv [1], "rb"); 

if (fpSrc == NULL) 

{ 

printf ("Could not open %s\n", argv [1]); 
return; 

} 

fpDst = fopen (argv [2], "wb"); 

if (fpDst == NULL) 

{ 

fclose (fpSrc); 

printf ("Could not open %s\n", argv [2]); 
return; 

} 

do 

{ 

byte = fgetc (fpSrc) ; 
if (byte == EOF) 
break; 

if (fputc (byte, fpDst) EOF) 
{ 

printf ("Could not write byte\n"); 
break; 

} 

} 

while (1); 
fcloseall 0; 

} 

Error code testing increases program size. As Listing 9.1 shows, error codes 
are tested when attempts are made to open the source and destination files 
and when an attempt is made to perform a write operation. In addition. 
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notice the f close (fpSrc) ; function call. That function call duplicates the 
file-closing logic found in the f closeall ( ) ; function call at the end of the 
listing. 

The problems with the traditional exception-handling model, which was 
based on error code, led to the development of a new exception-handling 
model, based on objects. That model originated in a paper called 
Exception Handling for C++ (revised), written by Andrew Koenig and 
Bjarne Stroustrup (the father of C++). In April 1990, those men presented 
their paper at the USENIX C++ Conference (held in San Francisco). Java 
makes use of the principles laid out in that paper. 

According to the new model, when an exception occurs while a Java pro- 
gram is running, either the program or the JVM creates an object that 
describes the exception. The values of variables at the moment the excep- 
tion occurs can be included in the object. If the object is created by the pro- 
gram, the program passes that object to the JVM. When the JVM has the 
object, it searches the program for an exception handler that can handle 
the exception described by the object. If the JVM finds a handler, it passes 
that object to the exception handler. The exception handler then uses the 
object's contents to help it handle the exception. 

TIP 

Use Java's exception-handling meclianism instead of error code testing. That leads to 
code that is easier to read and programs that are more robust. 

An Exceptional API 

The standard class library includes classes (arranged in a hierarchy) that 
identify various kinds of exceptions. The root of that hierarchy is a class 
called Throwable. Only objects created from Throwable (and its subclasses) 
can be passed to the JVM. 

Throwable (located in the java.lang package) declares a private String field 
that identifies the reason for an exception. That field is assigned a refer- 
ence to a String object, either by directly calling the Throwable (St ring msg) 
constructor or by indirectly calling that constructor (by way of a subclass). 
That reference returns whenever Throwable's getMessage( ) method is called. 

✓ To learn more about packages, see "What Are Packages," p. 428. 

In addition to getMessage( ), Throwable declares several overloaded 
printStackTrace{ ) methods. Those methods each build a message consisting 
of an exception object's class name, the contents of the aforementioned 
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private String field (which identifies the reason for the exception), 
and the contents of the method call stack (as recorded by Throwable's 
f illlnStackTraceO method). The only difference between the 
printStackTraceO methods is where they send that information. For 
example, the no-argument printStackTraceO method sends that infor- 
mation to the standard error device. 

✓ To learn more about the standard error device, see "Working witli Streams," p. 634. 

Just as it is not a good idea to create an object from Object, it is also not a 
good idea to create an object from Tlnrowable. The resulting object is too 
generic (and meaningless). If you move one level down in the exception 
class hierarchy, you'll encounter the more specific Exception and Error sub- 
classes (located in the java.lang package). They serve to classify exceptions 
as either program-related or JVM-related. 

The Exception class is the root class of all classes describing those excep- 
tions related to a Java program. When a program-related exception occurs, 
either the program creates an object from one of those classes and passes 
that object to the JVM, or the JVM creates an object from one of those 
classes. To give yourself a taste of Java's Exception subclasses, check out 
Table 9.1. 

Table 9.1: Common Exception Subclasses 
Subclass Description 

ArithmeticException An object created from that class describes a 



ArraylndexOutOf BoundsException 



ClassNot Found Except ion 



NullPointerException 



FileNot Found Except ion 



lOException 



math problem (such as a division by zero 
attempt). 

An object created from that class describes an 
attempt to access an array element with a bad 
index. 

An object created from that class describes an 
attempt to load a class file that cannot be 
found. 

An object created from that class describes an 
attempt to load a file that cannot be found. 
An object created from that class describes a 
generic I/O failure. More specific subclasses 
(such as FileNotFoundException) should be 
used to describe more specific I/O failures. 
An object created from that class describes an 
attempt to access a field or call a method, by 
using an object reference variable that con- 
tains a null reference. 
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Table 9.1: continued 

Subclass Description 

SQLException An object created from that class describes a 

database operation (via JDBC) tliat fails. 

StringlndexOutOf BoundsException An object created from that class describes an 

attempt to access a nonexistent character in 
either a string object or a stringBuffer 
object. 



CAUTION 

It is not a good idea to create exception objects from the Exception class. That class 
is too generic and represents all kinds of program-related exceptions. Instead, you 
should created exception objects from classes like those shown in Table 9.1. 



The Error class is the root class of all classes describing those exceptions 
related to the JVM. Objects created from those classes represent serious 
problems. For example, if the JVM runs out of memory, it will create an 
object from its OutOf MemoryError class. There is little a program can do to 
guard against those kinds of failures: A program might attempt to nullify 
an array of object references (assuming it has such an array) and make 
a request to the garbage collector to free up that memory when an 
OutOf MemoryError occurs, but that's about it. To give yourself a taste of 
Java's Error subclasses, check out Table 9.2. 



Description 



Table 9.2: Common Error Subclasses 
Subclass 

AWTError 

ClassFormat Error 
InstantiationError 

NoClassDef FoundError 
OutOf MemoryError 



An object created from that class describes a 
serious problem with Java's Abstract 
Windowing Toolkit. 

An object created from that class describes an 
attempt to load a badly formed class file. 
An object created from that class describes an 
attempt to create an object from either an 
abstract class or an interface. (Although the 
compiler guards against that problem, invalid 
bytecode instructions that attempt to create 
such an object could be present in a modified 
class file.) 

An object created from that class describes 
the inability to locate a class file on which 
code in a currently executing class depends. 
An object created from that class describes a 
failed attempt to allocate memory. 
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Table 9.2: continued 

Subclass Description 

StackOverf lowError An object created from that class describes a 

recursive operation tliat resulted in too much 
memory being reserved on the stacl<. 

CAUTION 

It is not a good idea to create your own Error subclasses. Those subclasses represent 
JVM-related exceptions and not program-related exceptions. 



If you review Java's standard class library documentation, you'll encounter 
a Throws section for each method that is able to create and pass Exception 
and/or Error subclass objects to the JVM. For example, the Throws section 
to Object's cloneO method appears in Figure 9.1. 
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Figure 9.1: For each method that throws an exception, Java's standard 
class library documentation lists the name of each Exception and I or Error 
subclass. 



NOTE 

Instead of saying "create and pass Exception and/or Error subclass objects to the 
JVM," it is more common to say "throws an exception" where "exception" refers to a 
Throwable object (that is, an object created from Throwable or one of its subclasses). 



Checked and Unchecked Exceptions 

Java classifies all exceptions as either checked or unchecked. Think of a 
checked exception as a program-related exception based on a resource- 
related failure. Examples include security violation, not finding a file. 
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unable to access a database, cannot start a started thread, and so forth. 
During compilation, the compiler checks each method (including construc- 
tor methods) to see whether it throws checked exceptions. If so, that 
method must include a Throws clause that lists each checked exception's 
class name. If that is not done, the compiler reports an error. Objects cre- 
ated from Exception and all of its subclasses (apart from RuntimeException 
and its subclasses) represent checked exceptions. 

In contrast, an unchecked exception is based on either a flaw in the 
program's logic or a JVM failure. Some common examples include 

• Attempting to divide an integer by zero 

• Attempting to access an array element using a bad index 

• Attempting to create an array with a negative number of elements 

• Attempting to pass an invalid argument to a method 

• Unable to find a class file 

• Running out of memory 

• A badly formatted class file 

The compiler does not check whether unchecked exception class names are 
listed in a Throws clause, because unchecked exceptions can occur at many 
points in a program, and having to list those names in Throws clauses 
would be an irritant to developers. Furthermore, for those JVM-related 
unchecked exceptions (identified by Error subclasses), recovery is difficult 
or impossible. Therefore, it is pointless to list such exceptions in a Throws 
clause. Objects created from RuntimeException and its subclasses (and Error 
and its subclasses) represent unchecked exceptions. 

NOTE 

As a Java developer, it is your responsibility to ensure that all checked exceptions are 
properly handled and that no unchecked exceptions (apart from those identified by 
Error subclasses) occur 

Creating Your Own Exception Classes 

At some point, you might need to create a new exception class. However, 
you would only do that if the SDK's documentation does not reveal an 
appropriate existing class. If that new exception class is to represent a 
checked exception, derive it from Exception or one of its subclasses (apart 
from RuntimeException or one of its subclasses). But if that class is to repre- 
sent an unchecked exception, derive that class from RuntimeException or one 
of its subclasses. 
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Because it is unusual to create an exception class that describes an 
unchecked exception, let's focus on an exception class that describes a 
checked exception. Consider Listing 9.2's TemperatureException class. 

Listing 9.2: TemperatureException . j ava. 
// TemperatureException. i ava 

class TemperatureException extends Exception 
{ 

private double temperature; 
TemperatureException () 

super ("Temperature out of range."); 

TemperatureException (String msg) 
super (msg); 

public void setTemperature (double temperature) 
this. temperature = temperature; 

public double getTemperature () 
return temperature; 

} 

Listing 9.2 introduces the TemperatureException checked exception class. 
TemperatureException extends Exception and presents two constructors: a 
no-argument constructor and a constructor that takes a single String 
argument. The no-argument constructor calls the Exception(String msg) 
constructor, by way of super ("Temperature out of range .");. In turn, 
Exception(String msg) passes "Temperature out of range ." to Throwable's 
Throwable (String msg) constructor, which assigns "Temperature out of 
range. " to its private String field. In contrast, TemperatureException (String 
msg) passes msg to Exception (String msg), by way of super (msg);. 

TIP 

Always end a new Exception subclass with the word Exception. That practice helps 
the reader quickly determine the class's purpose. 
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Notice the private double temperature field variable, along with 
setTemperatureidouble temperature) and getTemperature( ). The 
combination of that field and those methods shows that it's possible 
to supply additional information that describes an exception. You'll see 
more of the TemperatureException class as you progress through this 
chapter. 




EXAMPLE 



Throwing Exceptions 



When program code detects an exception, it creates an object from a suit- 
able exception class and passes that object to the JVM — a task known as 
throwing an exception. To throw an exception, you must use Java's Throw 
statement. If the exception is checked, you typically list the exception's 
class name in a method's Throws clause. Alternatively, you can place the 
code that throws the checked exception in a Try statement with a Catch 
clause that can handle the exception. 

The Throw Statement 

The Throw statement throws an object, describing an exception, to the 
JVM. The JVM gains control and begins searching for an exception handler 
that handles the exception. The following syntax expresses a Throw state- 
ment in source code: 
'throw' expression ' ; ' 

The Throw statement begins with the throw reserved word. That is followed by 
an expression that returns a reference to an object, created from Throwable or 
one of its subclasses. That object should describe the reason for the exception. 

The following code fragment demonstrates a Throw statement: 
TemperatureException te; 

te = new TemperatureException {"Temperature too low"); 
te.setTemperature (70.0); 
throw te; 

The code fragment demonstrates throwing the TemperatureException 
checked exception (whose class was introduced earlier in this chapter). 
A TemperatureException object is created, and a suitable reason for the 
exception is passed in the constructor's String argument. Furthermore, 
additional information describing the exception is supplied in a call to 
TemperatureException's setTemperature( ) method. Finally, the exception is 
thrown. 

Checked exceptions aren't the only exceptions that can be thrown: The 
Throw statement can also throw unchecked exceptions. 
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The following code fragment demonstrates a Throw statement being used to 

throw an unchecked exception: 

double divide (double numerator, double denominator) 

{ 

if (denominator == 0.0) 

throw new ArithmeticException ("Divide by zero"); 

else 

return numerator / denominator; 

} 

As a rule, you will typically throw checked exceptions. There is little point 
in throwing unchecked exceptions because either the exception is related to 
the JVM (by way of Error and its subclasses) or the program logic is flawed 
and needs to be fixed. However, you might find occasion to throw 
NullPointerException, IndexOutOf BoundsException, I llegalArgument Except ion, 
and other unchecked exception class objects, especially if you are creating a 
class library and there is the possibility that methods calling that library's 
methods will pass incorrect arguments. Such library methods must check 
their arguments and throw appropriate unchecked exceptions when bad 
arguments are detected. That is precisely what the code fragment's divide ( ) 
method does. 

The Throws Clause 

The Throws clause lists all the class names of checked exceptions that are 
thrown (either directly or indirectly, via method calls) from a method. The 
following syntax expresses a Throws clause in source code: 
'throws' exceptionldentifierl ',' exceptionIdentifier2 ',' ... 

The Throws clause begins with the throws reserved word. That reserved 
word is followed by a comma-delimited list of exception identifiers — the 
Throwable and subclass names. A Throws clause appends to a method's 
signature. 

The following code fragment demonstrates a Throws clause appended to the 
main ( ) method signature: 

public static void main (String [] args) throws lOException 
{ 

System. out. println (System. in. read ()); 

} 

System. in. read 0 is designed to throw an lOException object that describes 
an input/output exception. Because the main ( ) method is not handling that 
checked exception, it lists lOException in main( )'s Throws clause. The idea is 
for mainO's caller to handle the exception. Basically, main() "passes the 
buck" to its caller. 
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CAUTION 

Throwing a checked exception from a method that either does not specify a Throws 
clause or specifies a Throws clause without that exception's class name (or a super- 
class name) causes the compiler to report an error. However, it is not an error to list an 
unchecked exception's class name in a Throws clause. 




EXAMPLE 



Throws Clauses and Constructors 

What happens when a problem is detected within a constructor? The con- 
structor cannot return a value to indicate the problem. Instead, the object 
is created but left in an improperly initialized state. One way to deal with 
that problem is to initialize a publicly visible field to a success or error 
value — an error code — and have the caller check that error code, but we can 
do better. In such a situation, the constructor should throw an exception. 

Suppose you decide to write a Merge class with a merge ( ) method that 
merges a pair of sorted text files into a single text file. As part of your 
design, you will pass a pair of Strings, where each String names a text file, 
to Merge's constructor. After some thought, you decide to check for the exis- 
tence of each text file in the constructor. (There is no point in creating a 
Merge object if one or both text files don't exist.) If a file does not exist, you 
decide to create a FileNotFoundException object that describes that exception 
and then throws that object. Furthermore, because FileNotFoundException 
represents a checked exception, you realize that you will be required to list 
that class name in the constructor's Throws clause. Listing 9.3 demon- 
strates those tasks. 

Listing 9.3: MergeFiles . java. 
// MergeFiles. java 

import java.io.*; 

class Merge 
{ 

private File firstFile, secondFile, tmpFile; 

Merge (String f ileNamel , String fileName2) 
throws FileNotFoundException 

{ 

firstFile = new File (f ileNamel ) ; 
if ( !f irstFile.exists {)) 

throw new FileNotFoundException (fileNanel); 

secondFile = new File (fileName2); 
if (! secondFile. exists ()) 

throw new FileNotFoundException (fileNane2); 
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Listing 9.3: continued 
//. . . 

} 

boolean merge () 
{ 

boolean errorStatus = false; // Assume no error. 

// Use firstFile, secondFile, and tmpFile to do the merge. 

return errorStatus; 

} 

} 

class MergeFiles 
{ 

public static void main (String [] args) throws FileNotFoundException 
{ 

Merge m = new Merge ("a.dat", "b.dat"); 

} 

i 



NOTE 

MergeFiles introduces an Import directive: import java.io.*;. Chapter 11 explains 
Import directives. 

By creating an object from the standard class library's File class, with the 
filename String as the argument to one of File's constructors, and then by 
calling File's exists () method, you can easily determine whether the file 
exists. If either file does not exist, a FileNotFoundException object is thrown. 
Because mainO does not handle the "checked file not found" exception, its 
Throws clause lists FileNotFoundException. 

✓ To learn more about File, see "Working with Files," p. 612. 

What happens if a.dat doesn't exist and java MergeFiles is used to run 
the program? The following prints: Exception in thread "main" 
java.io. FileNotFoundException: a.dat (along with a stack trace of method 
calls that lead to that exception). 



NOTE 

If an exception is thrown out of an application's main ( ) method, a default Catch clause 
executes. That Catch clause calls printStackTrace{ ) to print a trace of nested 
method calls that were pending completion when the exception was thrown. 
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Throws Clauses and Inheritance 

A superclass method can declare a Throws clause with a list of checked 
exception class names. A subclass method that overrides that superclass 
method can also declare a Throws clause. However, the subclass method's 
Throws clause cannot list checked exception class names that are not listed 
in the superclass method's Throws clause. 

The following code fragment demonstrates some interesting things about 
Throws clauses and inheritance: 
import java.io.*; 

class Superclass 
{ 

void superMethod () throws lOException 

{ 

} 

} 

class Subclass extends Superclass 




EXAMPLE 



{ 



void superMethod () throws lOException, ArithneticException, 

FileNotFoundException, SQLException 

{ 
} 



} 



When examining the code fragment, the first thing to notice is the absence 
of Throw statements: None are required. You can list checked exception 
class names (such as lOException) in a Throws clause without actually 
throwing a checked exception object in the method. However, that is poor 
programming practice. 

TIP 

If you specify a Throws clause that lists the class name of a specific kind of checked 
exception, make sure the method either throws the exception or calls another method 
that throws the exception. 

Moving right along, notice each Throws clause. Superclass's and Subclass's 
superMethod ( ) methods both list lOException in their Throws clauses. It 
would be an error for Subclass's superMethod ( ) Throws clause to omit 
lOException. 

Hey! Wait a minute! What's ArithmeticException doing in Subclass's 
superMethod ( ) Throws clause? The answer: You can list as many unchecked 
exception class names as you like in a Throws clause. The compiler ignores 
those class names. 
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TIP 

Don't list unchecked exception class names in a throws clause: Those names aren't 
required and only clutter up the source code, which can confuse anyone trying to under- 
stand your code. 

Here's something strange: Why is FileNotFoundException Hsted in 
Subclass's superMethodO Throws clause? Shouldn't it also appear in 
Superclass's superMethodO Throws clause? No: It is perfectly legal to 
list FileNotFoundException in Subclass's superMethodO Throws clause 
because FileNotFoundException is a subclass of lOException, and 
lOException appears in Superclass's superMethodO Throws clause. 

Finally, note SQLException. Because that checked exception class name is 
listed in Subclass's overridden superMethodO Throws clause and not listed in 
Superclass's superMethodO Throws clause, the compiler reports an error. 
That is equivalent to overriding a superclass method with a subclass 
method that alters the method's return type. 

CAUTION 

Listing checked exception class names in a subclass method's Throws clause that are 
not listed in a superclass method's Throws clause causes the compiler to report an 
error. 



The Try Statement 

If you choose not to "pass the buck," by way of a Throws clause, you must 

declare a Try statement that surrounds those statements that have the 

potential to throw exceptions. Express a Try statement in source code by 

using the following syntax: 

'try' 

■{■ 

statement . . . 

■}■ 

The Try statement begins with the try reserved word. That is followed by a 
block of statements, known as a Try block, that have the potential to throw 
exceptions. In a sense, those statements are "tried" to see whether any of 
them throw an exception. 

TIP 

A Try block must be immediately followed by either a Catch clause, a Finally clause, or 
some combination of clauses. 
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^ \ I / The following code fragment attempts to open a file (abc . dat) and connect it 
s r IB^ input stream (an object that attempts to open a file and, on request, 

^ returns its bytes one byte at a time): 

EXAMPLE FilelnputStream fis = null; 



try 
{ 

} 



fis = new FilelnputStream ( "abc.dat" ) ; 



The FilelnputStream constructor contains code that tries to open abc.dat 
and associate that file with an input stream. If abc . dat is not found (or can- 
not be opened, for some reason), the exception results in the constructor 
creating a FileNotFoundException object and throwing that object to the 
JVM. If that exception is thrown, no FilelnputStream object is created and 
fis contains its default value. 



✓ To learn more about FilelnputStream, see "Working with Strea m s , " p. 634. 

If an exception is not thrown from a Try block, all statements in the block 
execute and execution picks up with the first statement that follows the 
block. However, if an exception is thrown and an exception handler is 
located to handle that exception, the Try statement does not re-execute the 
block's statement that threw the exception. For all intents and purposes. 
Try is finished after an exception is thrown. 



Catching Exceptions 



When the JVM receives an exception object, it searches for an exception 
handler designed to handle exceptions of the type specified by the object. 
The search begins with the nearest Catch clause of a Try block that sur- 
rounds the code that throws the exception and continues up the method call 
stack until a Catch clause is found that can handle the exception. After the 
exception handler has been found, the object is passed to the handler, and 
the exception is said to be caught. 

What happens if the JVM cannot find an exception handler? For non-GUI- 
based applications, a default Catch clause surrounding a call to the main ( ) 
method executes. That clause prints a stack trace of method calls, and the 
application terminates. However, GUI-based applications continue running, 
but they run with the possibility of corrupt logic and are not considered 
reliable. 
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The Catch Clause 

A Catch clause serves as an exception handler for either its preceding Try 
block or some other Try block. The following syntax expresses a Catch 
clause in source code: 

'catch' '(' exceptionldentifierobjectldentifier ')' 
'{■ 

statement . . . 

■}■ 

The Catch clause begins with the catch reserved word. That is followed by a 
parameter list consisting of a single parameter. The type of that parameter 
is exceptionldentifier, and its name is objectldentifier. The type is noth- 
ing more than an exception class and the name is nothing more than a 
variable that holds a reference to the exception object, when the JVM 
passes control to the Catch clause. 



CAUTION 

exceptionldentifier must be either Throwable or the name of a class that inherits 
from Throwable. Any other class name causes the compiler to report an error. 
Furthermore, specifying more than one parameter causes the compiler to report an 
error. 



The parameter list is followed by a block of statements that are executed 
when the JVM passes control to the Catch clause. 



TIP 

If your program doesn't work and no messages are displayed that indicate a problem, it 
is possible that the JVM has passed control to an empty Catch clause (that is, a Catch 
clause that contains no statements). 



The following code fragment demonstrates a Catch clause that catches a 
TemperatureException object (whose class was presented earlier in this chap- 
ter) describing a temperature exception and handles that exception: 

catch (TemperatureException e) 
{ 

System. out. println (e.getMessage ()); 

// Let's assume a program containing this code fragment contains 
// an adjustTemperatureO method that makes an adjustment to the 
// current temperature. 

adjustTemperature (e.getTemperature ()); 

} 
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EXAMPLE 



The Catch clause calls TempenatuneException's inherited getMessage() method 
to obtain a descriptive message concerning the exception, which subse- 
quently prints. Also, getTemperature( ) is called to retrieve the actual tem- 
perature setting, and that value passes as an argument to some 
hypothetical adj ustTemperatureC ) method, which would modify the tempera- 
ture to a specific setting. 

The following code fragment provides a more complete example of exception 
handling. The example demonstrates a Try block consisting of code that 
attempts to open a file called abc . dat and connect an input stream to that 
file. However, if abc. dat doesn't exist, the FilelnputStream constructor 
throws an exception object (of type FileNotFoundException). 
FilelnputStream fis = null; 

try 
{ 

fis = new FilelnputStream ("abc. dat"); 

} 

catch (FileNotFoundException e) 
{ 

System. out. println (e.getMessage ()); 



_Q_ e.printStackTrace (); 



The Catch clause following the Try block indicates that it can catch excep- 
tions of type FileNotFoundException. When the FilelnputStream constructor 
throws that exception to the JVM, the JVM locates the Catch clause. After 
the JVM verifies that the Catch clause can accept FileNotFoundException 
objects, it passes the FileNotFoundException object reference to the Catch 
clause, by way of object reference variable e. The Catch clause handles that 
exception by printing the reason for the exception, by way of the 
getMessage( ) method's return value (which includes the name of the file 
that could not be opened, in the example) and a stack trace of methods that 
were called (but not completed) when the exception was thrown. 

CAUTION 

Placing statements between a Catch clause and either a preceding Try block or a pre- 
ceding Catch clause causes the compiler to report an error. 



Multiple Catch Clauses 

A Try block can be followed by multiple Catch clauses, making it possible to 
catch different kinds of exceptions in one location. Except for the first Catch 
clause, each Catch clause follows the preceding Catch clause with no inter- 
vening statements. 
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The following code fragment demonstrates a portion of a text file viewer 
program. Multiple Catch clauses are specified to respond to different kinds 
of exceptions: 
FilelnputStream fis = null; 

try 
{ 

fis = new FilelnputStream (new File (args [0])); 
int byte_; 

while ({byte_ = fis. read ()) != -1) 
System. out. print ((char) byte_) ; 

fis. close {); 

System. out. println (""); 

} 

catch (FileNotFoundException e) 
{ 

System. out. println ("File not found!"); 

try { fis. close (); } catch (lOException e2) {} 

} 

catch (lOException e) 
{ 

System. out. println ("Unable to read file!"); 
try { fis. close (); } catch (lOException e2) {} 

} 

Notice the two non-nested Catch clauses. The first Catch clause deals with 
FileNotFoundException objects that might be thrown by the FilelnputStream 
constructor, whereas the second Catch clause deals with any lOException 
object that might be thrown from the read ( ) method. In both cases, those 
Catch clauses print a message and close the file. 

Notice the Catch clauses associated with the Try statements whose blocks 
consist of fis . close ( ) ; . Each of those Catch clauses specifies a parameter 
named e2. You might be wondering why e cannot be redeclared. The answer 
is: The scope of parameter e extends throughout its Catch clause's state- 
ment block. When a Try statement with its own Catch clause nests inside a 
Catch clause, the nested Catch clause's parameter is within the scope of the 
outer Catch clause's parameter, and it isn't legal to declare parameters with 
the same name in the same scope. 
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CAUTION 

Attempting to redeclare a Catch clause's parameter in a nested Catch clause causes 
the compiler to report an error Furthermore, specifying two or more Catch clauses with 
the same parameter type after a Try statement causes the compiler to report an error. 

There is one problem with the code fragment: redundant file-closing code. 
Not only is the file associated with the f is input stream closed from within 
the Try block (if no exception is thrown), but it is also closed from within 
each nested Catch clause (if either a FileNotFoundException object or an 
lOException object is thrown). Because it's not possible to come back to the 
Try block (after executing the statements in the Catch clause) and attempt 
to close the file, the file-closing code must be duplicated in several places. 
Fortunately, there is a way to eliminate that redundancy — use a Finally 
clause, which will be discussed shortly. 

Can the order of multiple Catch clauses be switched? For example, could the 
outer Catch clause that catches lOException objects be specified before the 
Catch clause that catches FileNotFoundException objects? In that case, the 
answer is no. lOException is the superclass of FileNotFoundException. If a 
Catch clause for lOException objects could be specified before a Catch clause 
for FileNotFoundException objects, a FileNotFoundException object would be 
handled by the lOException Catch clause. The reason that happens has to 
do with polymorphism. Because a FileNotFoundException object is a kind of 
lOException, the JVM would pass the FileNotFoundException object to the 
lOException catch clause handler. And because the compiler is designed to 
prevent dead code (code that never executes), it reports an error when 
encountering a Catch clause that catches objects of a superclass type before 
a Catch clause that catches objects of a subclass type. 

CAUTION 

Do not place a Catch clause with a superclass exception type before a Catch clause 
with a subclass exception type when multiple Catch clauses are specified after a Try 
block. If you violate that rule, the compiler will report an error. 



Throwing Exceptions from Catch Clauses 

Sometimes, it is necessary to throw an exception from within a Catch 
clause. Either the same exception can be rethrown, or a new exception can 
be thrown. You typically throw exceptions from Catch clauses when devel- 
oping a class library. 

When you build a class library, you never know who will call your library's 
methods, and whether correct or incorrect arguments will be passed. 
Suppose a library method calls an internal method to help accomplish its 
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task. As part of the call, the library method passes one or more of its argu- 
ments to that internal method. Furthermore, suppose that internal method 
call is placed in a Try block. If incorrect arguments are passed to the inter- 
nal method, it throws an exception. The Catch clause that's associated with 
that Try block handles that exception. However, should the library method 
continue or should it notify its caller that something has gone wrong? 
Typically, notification is in order. Depending on how the library was 
designed, the same exception can be rethrown from the Catch clause, or a 
new exception can be created and thrown. That choice is determined by the 
library's guidelines. If those guidelines explicitly identify the exceptions 
that are to be thrown, a new exception created from an appropriate class 
must be thrown. Otherwise, the same exception could be rethrown. 

To get an idea of how to go about rethrowing the same exception from a 
Catch clause, check out Listing 9.4's source code to the ThrowAgain applica- 
tion. 

Listing 9.4: ThrowAgain. java. 
// ThrowAgain. java 

class MyException extends Exception 
{ 

MyException () 
{ 

super { "My Exception" ) ; 

} 

} 

class ThrowAgain 
{ 

public static void main (String [] args) 
{ 

try 
{ 

someMethodi (); 

} 

catch {MyException e) 
{ 

System. out. println ("nain(): " + e.getMessage ()); 
e.printStackTrace (); 

} 

} 

static void someMethodi () throws MyException 
{ 

try 
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OUTPUT 



Listing 9.4: continued 
{ 

someMethod2 (); 

} 

catch {MyException e) 
{ 

System. out. println ( "someMethodI ( ) : " + e.getMessage ()); 
e.printStacklrace (); 
throw e; 

} 

} 

static void someMethod2 () throws MyException 
{ 

throw new MyException (); 

} 

} 

ThrowAgain declares a checked exception class called MyException. To keep 
things simple, only one constructor is specified. That constructor passes "My 
Exception! " to the Exception superclass layer. 

ThrowAgain also declares main ( ) , someMethodI ( ) , and someMethod2 ( ). main ( ) 
begins its execution by calling someMethodI (), which calls someMethod2( ). 
someMethod2( ) throws a new MyException ( ) checked exception object. Because 
someMethod2( ) is called from within someMethodI ( )'s Try block, the JVM 
locates someMethodI ( )'s Catch clause and passes the object to that clause. 
After printing some information, someMethodI ()'s catch clause executes throw 
e;, which rethrows the same exception. That exception is caught by main()'s 
Catch clause, main ( ) prints some information and exits. 

ThrowAgain produces the following output: 

someMethodI {) : My Exception 
MyException: My Exception 

at ThrowAgain . soneMethod2 (ThrowAgain . j ava : 42 ) 

at ThrowAgain . someMethodI (ThrowAgain. iava:30) 

at ThrowAgain. main (ThrowAgain. j ava: 17) 
main( ) : My Exception 
MyException: My Exception 

at ThrowAgain . someMethod2 (ThrowAgain . j ava : 42) 

at ThrowAgain. someMethodI (ThrowAgain. java:30) 

at Th rowAgain . main (Th rowAgain . j ava : 1 7 ) 

Lines someMethodI 0 : My Exception and main() : My Exception result from 
printing appropriate strings and getMessage( ) return values. The other 
lines result from calls to printStackTrace( ). As you can see, each 
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pnintStackTrace( ) method call prints the following: the name of the excep- 
tion class (which is MyException), the contents of the private String field 
(which getMessage( ) returns — My Exception), and a trace of outstanding 
(that is, not completed) method calls. 

To get an idea of how to go about throwing a new exception from a Catch 
clause, check out Listing 9.5's source code to the ThrowNew application. 

Listing 9.5: ThrowNew. Java. 
// ThrowNew. Java 

Class MyException extends Exception 
{ 

MyException () 
{ 

super { "My Exception" ) ; 

} 

} 

class YourException extends Exception 
{ 

YourException () 
{ 

super {"Your Exception"); 

} 

} 

class ThrowNew 
{ 

public static void main (String [] args) 
{ 

try 
{ 

someMethodi (); 

} 

catch {MyException e) 
{ 

System. out. println (e.getMessage ()); 

} 

} 

static void someMethodi () throws MyException 
{ 

try 
{ 

someMethod2 (); 
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Listing 9.5: continued 
} 

catch {YourException e) 
{ 

System. out. println (e.getMessage ()); 
throw new MyException (); 

} 

} 

static void someMethod2 () throws YourException 
{ 

throw new YourException (); 

} 

} 

In many ways, ThrowNew is similar to ThrowAgain. However, there are some 
differences. First, a YourException class is declared. Second, somel\/lethod2( ) 
does not throw a new MyException object — it throws a new YourException 
object. Third, there are no e.printStacklraceO ; statements. Finally, 
someMethodi ( )'s Catch clause doesn't execute throw e;. Instead, it executes 
throw new MyException ( ) ;. Basically, a Catch clause has caught one excep- 
tion and is throwing a new exception. 

ThrowNew produces the following output: 

Your Exception 
c^/.W' MyException 

There is a problem with throwing a new exception from a Catch clause. 
OUTPUT Information about the original exception (such as the location from where 
the original exception was thrown) is lost when the new exception is han- 
dled. For example, notice the Catch clause that catches a YourException 
object and immediately throws a new MyException object in Listing 9.5. 
When MyException is handled (in some other Catch clause), information on 
the location of where the YourException object was thrown is lost. That loss 
of information complicates debugging. 

Developers typically deal with the aforementioned problem by wrapping the 
original exception inside a new exception object and throwing the new 
object. Because the new exception "chains" to the wrapped exception, that 
activity is known as exception chaining. Due to the many implementations of 
exception chaining. Sun has recognized the need to standardize. Therefore, 
Sun has made changes to several key classes. Collectively, those changes 
offer a standardized exception chaining facility. 



1.4 
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To begin, Sun added two new methods to Throwable: getCause() and 
initCause(Throwable t). The getCauseO method returns a reference to the 
wrapped Throwable. For example, getCause( ) would return a reference to 
YourException (using the previous example). The initCause(Throwable t) 
method assigns an exception reference (in argument t) to a private field in 
Throwable. That reference returns from getCause(). The initCause (Throwable 
t ) method is designed to be called at most once, and is typically called from 
a Throwable constructor. 

To support initCause(Throwable t). Sun has introduced two new Throwable 
constructors: Throwable (Throwable cause) and Throwable(String message, 
Throwable cause). Those constructors assign the exception referenced by 
cause to a private field in Throwable. Also, general-purpose exception classes 
(such as Exception, RuntimeException, and Error) have been modified by 
adding new constructors that call the new Throwable constructors. 

Support concludes with a modification to Throwable's printStackTrace( ) 
methods (to display a backtrace of chained exceptions), the introduction of a 
new getStackTrace( ) method (in Throwable) that provides programmatic 
access to stack trace information, and a new StackTraceElement class (in the 
java.lang package), that describes one element of the stack trace. 

Listing 9.6's ChainDemo source code demonstrates the use of 
initCause (Throwable t) to chain one exception to another and 
printStackTraceO to display a backtrace of chained exceptions. 

Listing 9.6: ChainDemo. Java. 
// ChainDemo. java 

class MyException extends Exception 
{ 

MyException () 
{ 

super ( "My Exception" ) ; 

} 

} 

class YourException extends Exception 
{ 

YourException () 
{ 

super ("Your Exception"); 

} 

} 

class ChainDemo 



11 71710_CH09 11/21/01 11:45 AM Page 358 q 



358 Chapter 9: Exceptions and Exception Handlers 



Listing 9.6: continued 
{ 

public static void main (String [] args) 
{ 

try 
{ 

someMethodi (); 

} 

catch {MyException e) 
{ 

e.printStackTrace (); 

} 

} 

static void someMethodi () throws MyException 
{ 

try 
{ 

soneMethod2 (); 

} 

catch (YourException e) 
{ 

System. out. println (e.getMessage ()); 
MyException e2 = new MyException (); 
e2.initCause ; 
throw e2; 

} 

} 

static void someMethod2 () throws YourException 
{ 

throw new YourException (); 

} 

} 

ChainDemo's source code is similar to ThrowNew's source code. The two main 
differences are e2.initCau8e ; in someMethodi ()'s Catch clause and 
e.printStackTrace ( ) ; in [nain( )'s Catch clause. To perform exception chain- 
ing, where YourException information is wrapped in a MyException object, 
someMethodi ( )'s Catch clause wraps the YourException object (referenced by 
e) in the MyException object (referenced by e2) by calling e2.initClause ;. It 
then calls throw e2; to throw the MyException object. When main()'s Catch 
clause is called to handle that exception, it calls e . printStackTrace ( ) ; to 
print the following backtrace of chained exceptions: 
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MyException: My Exception 

at ChainDemo.someMethodI (ChainDemo. java:42) 

at ChainDemo. main(ChainDemo. iava:25) 
Caused by: YourException : Your Exception 

at ChainDemo . someMethod2( ChainDemo . j ava : 50) 

at ChainDemo . someMethod2 {ChainDemo . j ava : 37) 

... 1 more 

How do you read the output? First, MyException identifies the class of the 
most recently thrown exception, and My Exception is that exception's text 
(as would be returned in a call to Throwable's getMessage( ) method). The at 
ChainDemo.someMethodI (ChainDemo. iava:42) line indicates that the most 
recent exception object, a MyException object, was created on line 42 
(MyException e2 = new MyException ();) in someMethodI () of source file 
ChainDemo . i ava. The at ChainDemo . main ( ChainDemo . j ava : 25 ) line identifies the 
location of the call to someMethodi ( ). 

What exception caused MyException to be thrown? The Caused by: 
YourException: Your Exception line provides that information. It states 
that a YourException object was thrown prior to MyException and that the 
message stored in YourException is Your Exception. The at 
ChainDemo. someMethod2(ChainDemo.iava:50) line indicates that a 
YourException object was created on line 50 (throw new YourException ();)in 
someMethod2( ) of source file ChainDemo. j ava. The at 

ChainDemo. someMethod2(ChainDemo.iava:37) line identifies the location of the 
call to someMethod2(). 

Finally, what does the line beginning with . . . mean? Think of that line as a 
shorthand notation. Instead of repeating information shown in previous 
stack traces, lines beginning with . . . refer you to those earlier traces for 
additional information on the chain of method calls that led to the code that 
threw the exception. Specifically, ... 1 more indicates that the remainder of 
the stack trace for YourException matches the last line of the previous stack 
trace (for MyException). That line is at ChainDemo. main(ChainDemo.iava:25). 

The SDK documentation for Throwable's printStackTrace() method illus- 
trates the aforementioned shorthand notation in the context of an example 
program's stack trace. That stack trace follows: 
HighLevelException: MidLevelException: LowLevelException 

at Junk.a(Junk. java: 13) 

at Junk.main(Junk. java:4) 
Caused by: MidLevelException: LowLevelException 

at Junk.c(Junk. iava:23) 

at Junk. b(Junk. java: 17) 

at Junk.a(Junk. java: 1 1 ) 

... 1 more 



11 71710_CH09 11/21/01 11:45 AM Page 360 



360 Chapter 9: Exceptions and Exception Handlers 



Caused by: LowLevelException 

at Junk.e(Junk. ]ava:30) 
at Junk.d(Junk. iava:27) 
at Junk.c(Junk. ]ava:21 ) 
... 3 more 

You might find it confusing as to what ... 3 more and ... 1 more refer. To 
add clarity, I've rewritten the previous stack trace to show what it would 
like without the shorthand notation. The result is: 

HighLevelException: MidLevelException: LowLevelException 

at Junk. a(Junk. Java: 13) 

at Junk.main(Junk.]ava:4) 
Caused by: MidLevelException: LowLevelException 

at Junk.c(Junk. ]ava:23) 

at Junk. b(Junk. Java: 17) 

at Junk. a(Junk. Java: 1 1 ) 

at Junk.main(Junk. java:4) 
Caused by: LowLevelException 

at Junk.e(Junk. java:30) 

at Junk.d(Junk. java:27) 

at Junk.c(Junk. java:21 ) 

at Junk.b(Junk. java:17) 

at Junk.a(Junk. java: 1 1 ) 

at Junk.itiain(Junk.]ava:4) 

The ... 3 more under Caused by: LowLevelException refers to the at 
Junk . b(Junk . i ava: 1 7), at Junk. a(Junk. java: 11 ), and .. . 1 more lines under 
Caused by: MidLevelException: LowLevelException, and the ... 1 more refers 
to the at Junk.main(Junk. iava:4) line under HighLevelException : 
MidLevelException : LowLevelException. 



Cleaning Up 



While learning about multiple Catch clauses, you saw code (placed inside a 
Try block) that creates a FilelnputStream object via a call to 
FilelnputStream's constructor. You also observed that object's close () 
method was being called and that the method call was specified in three 
places: the Try block and the two non-nested Catch clauses. It's important 
to close the file associated with the stream. Unfortunately, that task neces- 
sitates redundant code — or does it? Redundant code can be avoided by spec- 
ifying a Finally clause to perform cleanup. 

The Finally Clause 

A Finally clause serves as a cleanup handler for a Try block. The following 
syntax expresses a Finally clause in source code: 
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'finally' 
■{■ 

statement . . . 

■}■ 

The Finally clause begins with the finally reserved word. That is followed 
by a block of statements that perform cleanup tasks on behalf of the preced- 
ing Try block. After the last statement in either a Try block or one of its 
Catch clauses has executed, the Try statement's Finally clause executes. 



TIP 

A Finally clause is a good place to put code that releases resources acquired in a Try 
blocl<. For example, if a Try block opens a file, a Finally clause should contain code that 
closes the file. 

The following code demonstrates the use of a Finally clause to eliminate 
redundant code: 
FilelnputStream fis = null; 

try 
{ 

fis = new FilelnputStream (new File (args [0])); 
int byte_; 

while ({byte_ = fis. read ()) != -1) 
System. out. print ((char) byte_) ; 

System. out. println (""); 

return; 

} 

catch (FileNotFoundException e) 
{ 

System. out. println ("File not found!"); 

} 

catch (lOException e) 
{ 

System. out. println ("Unable to read file!"); 

} 

finally 
{ 

if (fis != null) 
try 
{ 

fis. close 0; 

} 
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EXAMPLE 



catch {lOException e) 

{ 

} 



} 



Whether or not an exception is thrown, the Finally clause closes the file 
associated with the input stream. 

If there is no Catch clause, the Finally clause executes before the JVM 
leaves the current method and continues its search for a Catch clause. 

The following code fragment demonstrates throwing a checked exception 
and executing a Finally clause before the JVM searches for a Catch clause: 
try 
{ 

throw new InterruptedException (); 

} 

finally 
{ 

System. out. println ("Goodbye from this method."); 

} 

CAUTION 

Placing statements between a Finally clause and either a preceding Try block or a pre- 
ceding Catch clause causes the compiler to report an error. 



Throwing Exceptions from Finally Clauses 

Like Catch clauses, a Finally clause might throw an exception, but that 
could be dangerous. For example, code placed within a Try block throws an 
exception, and there is no Catch clause following the try block to handle 
that exception. The JVM must search the method call stack for a method 
containing an appropriate exception handler. However, because the Try 
block is immediately followed by a Finally clause, the Finally clause exe- 
cutes before the JVM begins its search. The Finally clause executes some 
code resulting in an exception and decides to throw that exception. That 
thrown exception replaces the exception that was thrown from within the 
Try block. As a result, an exception is lost and the original failure not han- 
dled. 

\ I / It isn't difficult to lose an exception. Listing 9.7's source code to the 
01 LostException application demonstrates the loss of a YourException 
exception. 

EXAMPLE 
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Listing 9.7: LostException. Java. 
// LostException. java 

class MyException extends Exception 
{ 

MyException () 
{ 

super { "My Exception" ) ; 

} 

} 

class YourException extends Exception 
{ 

YourException () 
{ 

super {"Your Exception"); 

} 

} 

class LostException 
{ 

public static void main (String [] args) 
{ 

try 
{ 

someMethodi (); 

} 

catch {MyException e) 
{ 

System. out. println (e.getMessage ()); 

} 

catch (YourException e) 
{ 

System. out. println (e.getMessage ()); 

} 

} 

static void someMethodi () throws MyException, YourException 
{ 

try 

{ 

someMethod2 (); 

} 

finally 
{ 

throw new MyException (); 
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Listing 9.7: continued 
} 

} 

static void someMethod2 () throws YourException 
{ 

throw new YourException (); 

} 

} 

someMethodi ( ) calls someMethod2( ), which throws a new YourException object. 
The JVM examines someMethodi ( ) for a Catch clause that can handle that 
exception. It doesn't find that Catch clause but does find a Finally clause. 
Therefore, the JVM executes the Finally clause before continuing its 
search. However, the Finally clause executes throw new MyException () ;. 
The JVM is now a position where it must stop searching for a Catch clause 
that handles YourException and begin searching for a Catch clause that 
handles MyException. The result is that the exception created from 
YourException has been lost. 



OUTPUT 



LostException produces the following output: 
My Exception 



CAUTION 

If a Try block throws an exception and there is no Catch clause in the same method 
that can handle that exception, a Finally clause appearing in the same method as the 
Try block will execute. If that clause's execution results in another exception being 
thrown, the original exception is lost. 



What's Next? 



Computer languages have evolved in the way they allow developers to deal 
with failure. Java's support for exceptions and exception handlers facili- 
tates that task. In the next chapter, the concept of threads is introduced. 
Among the various threading topics that are discussed, you will learn about 
the InterruptedException class. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 

NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 
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Reviewing It 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. What are the five exception-handling reserved words? 

2. Why must checked exceptions be handled? 

3. How do you declare a method that can throw one or more exceptions? 

4. Throwable's subclasses inherit the no-argument Throwable constructor. 
Unlike Throwable's other constructor, the no-argument constructor 
doesn't initialize the internal exception message field. As a result, a 
call to getMessage( ) returns null. Given that situation, why might you 
want to call the no-argument constructor? 

5. If a variable is declared within a Try block, can that variable be 
accessed from within either a subsequent Catch clause or a subse- 
quent Finally clause? 

6. If a Try block does not throw an exception, to where does execution 
proceed when the Try block completes? 

7. What is the purpose of Throwable's f illlnStackTrace( ) method? 



Checl^ing It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. When you throw an exception from a Finally clause, what happens? 

a. The original exception is lost (if an exception was thrown). 

b. The JVM searches the method call stack for a handler. When 
found, the exception is handled and then the Finally clause exe- 
cutes. On encountering the new exception, the JVM searches for 
an appropriate handler. 
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c. The JVM always terminates the program. 

d. None of the above. 

2. Which class is the root class of the exception class hierarchy? 

a. Error 

b. Exception 

c. Throwable 

d. RuntimeException 

3. Why would you throw an exception from some Catch clause in a 
library method? 

a. To conform the method to some specification 

b. To indicate that an invalid argument was passed to the method 

c. a and b 

d. None of the above 

4. Which of the following exception classes is the superclass of other 
exception classes? (You might need to check the SDK documentation.) 

a. EOFException 

b. FileNotFoundException 

c. InterruptedlOException 

d. lOException 

5. Which of the following clauses is also used by C++'s exception- 
handling mechanism? 

a. Throws 

b. Finally 

c. Catch 

d. All of the above 

6. Which of the following statements is false? 

a. After a Catch clause completes, execution continues with the first 
Try block statement that follows the statement that threw the 
exception. 

b. An exception handler can be located far from where an exception 
is thrown. 
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c. If a Try block is followed by a Finally clause, the Finally clause 
always executes — even if the Try block executes a Return, Break, 
or Continue statement to terminate the block. 

d. If you catch all exceptions with catch (Exception e), instanceof 
can be used to distinguish between exceptions. 

7. Which of the following statements is true? 

a. It isn't easy to ignore error codes. 

b. Exception handling cannot be used for purposes other than recov- 
ering from exceptions. 

c. Error-code-testing logic doesn't increase a program's size. 

d. Making the assumption that an exception thrown from a Catch 
clause will be caught by some other Catch clause associated with 
the same Try block can lead to logic problems. 

8. Which of the following activities does not result in an exception being 
thrown? 

a. Attempting to open a file that does not exist 

b. Attempting to divide a floating-point number by zero 

c. Attempting to access an array element with a negative index 

d. None of the above 

9. Which of the following Throwable methods returns a reference to either 
a Throwable object or an object from one of Throwable's subclasses? 

a. f illInStackTrace( ) 

b. printStackTrace( ) 

c. getMessage( ) 

d. toStringO 

10. What is an exception? 

a. A path of execution that diverges from its normal path 

b. An object thrown from a throw statement 

c. a only 

d. a and b 
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True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. When multiple Catch clauses follow a Try block, a Catch clause that 
catches objects of a superclass exception type must precede a Catch 
clause that catches objects of a subclass exception type. 

True/False 

2. A Throw statement can throw either checked or unchecked 
exceptions. 

True/False 

3. Checked exception objects are created from RuntimeException and its 
subclasses. 

True/False 

4. Unchecked exception class names must be listed in a method's Throws 
clause. 

True/False 

5. When an exception is thrown from a constructor, the object is not 
constructed. 

True/False 

6. A Try block must be followed by either a Catch clause or a Finally 
clause. 

True/False 

7. Exception objects always originate from Throw statements. 
True/False 

8. A Finally clause is always executed, whether or not an exception is 
thrown from a Try block. 

True/False 

9. A subclass method's Throws clause can list checked exception class 
names that do not appear in the Throws clause of the superclass 
method that it overrides. 

True/False 

10. In most circumstances, when creating a checked exception class, you 
should make that class a subclass of Exception and not Error. 

True/False 
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Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises. 

1. Write an ArraySize application that declares an integer variable 
named size and initializes that variable to - 1 . Within a Try block, 
attempt to allocate a char array with size elements, print the array's 
length, and use a Break statement to exit the Try block. Figure out 
what kind of exception gets thrown from the allocation attempt and 
create a Catch clause that handles the exception, by setting size to 10 
and printing the exception object. 

2. Write a CatchMultiple application that demonstrates how to catch mul- 
tiple kinds of exceptions in a single catch (Exception e) handler. Make 
sure you use instanceof in the Catch clause. 

3. Write a Rethrow application that introduces a My Except ion class (as a 
subclass of Exception) with a no-argument constructor that passes "My 
exception has been thrown. " to its superclass and demonstrates a 
main ( ) method with a Throws clause; a Try block in that method that 
throws a MyException object; a Catch clause in that method that 
catches the exception, prints the exception, and rethrows the excep- 
tion; and a Finally clause that prints a cleanup message. 

4. Modify Listing 9.4's ThrowAgain application by changing the throw e; 
statement in someMethodl ( )'s Catch clause to throw (MyException) 
e.f illlnStackTrace () ;. Compile and run the modified application. 
Now, compare its output to the unmodified ThrowAgain's output. What's 
different? Why is the (MyException) cast necessary? 
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Threads 

Modern operating systems support threads. Those independent units of 
execution can give programs a performance boost, by performing several 
operations at once. Java also supports threads, by adding a platform- 
independent Thread API layer on top of an operating system's threading 
logic. In this chapter, you will discover what threads are all about. 
Specifically, you will learn how to create and start threads with the Thread 
class and the Runnable interface, how to perform basic thread operations, 
how to use timers, how to synchronize access to shared data, the purpose 
of Java's volatile ke3rword, how Java schedules threads for execution 
(which includes the concept of priority), and how to group threads for 
organizational purposes. 
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What Are Threads? 



Modern operating systems use threads to improve performance. They also 
make that feature available to programs — via API libraries — so that those 
programs can benefit from a performance boost. Before examining the bene- 
fits of threads, we must first ask ourselves a question: What are threads? A 
thread is an independent execution path through program code. When mul- 
tiple threads are executing, each thread's execution path (through the same 
code) is typically different. For example, one thread might execute the If 
part of an If-Else decision statement and then execute a While loop state- 
ment several times, whereas a second thread might execute the Else part of 
the If-Else decision statement and completely bypass the While loop state- 
ment. Having multiple threads executing code in the same program, which 
is known as multithreading, is like having different to-do lists. After you 
finish a few of the tasks in one list, you might get bored and start accom- 
plishing some tasks in a second list. Following some of those tasks, you 
might continue with the first list (with the first unfinished task) or start on 
a third list. 

Multithreading is beneficial for at least three reasons: 

• It is often easier to split a program's independent tasks among multi- 
ple threads than to try to accomplish all of those tasks in a single 
thread. For example, a word processor might dedicate one thread to 
managing its GUI while a second thread takes care of pagination or 
save-to-file tasks, and a third thread takes care of a printing task. 

• The CPU does not waste all of its time waiting for resources. For 
example, if a thread manages network or file I/O, other threads can 
perform useful work while that other thread waits for the I/O opera- 
tion to complete. 

• Multithreading on a single-processor machine offers the illusion of 
faster performance, from the user's perspective. On a machine with 
multiple processors, a calculation can complete much faster than if it 
is executed on a machine with a single processor. That happens when 
each processor runs a thread that performs part of the calculation. 

For some languages, like C and C++, thread support is external: A Thread 
API library must be accessed to support threads in a program. In contrast, 
languages like Ada and Java support threads at the language level. From 
Java's perspective, certain thread features are part of the language and 
other thread features are part of the JVM. If you have never before encoun- 
tered threads, don't worry: You do not need to know how threads work at the 
operating system level. All you need to know is how to properly use threads 
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in your programs. And, if you don't think you will ever need to use threads, 
be aware that it is very difficult (if not impossible) to write a non-trivial 
Java program that does not use threads. 

TIP 

Although this chapter explores many thread concepts, an entire bool< is required to 
cover every facet of threads, from Java's point of view, in an appropriate level of detail. 
After you've worked your way through this chapter, you are encouraged to continue your 
Java thread education by reading a seven-part JavaWorld series called Programming 
Java Threads in thie Real World: 



Part 1 


(http 


/ /www 


j avaworld 


com/ i avaworld / jw 


09 


1998/ jw-09 


threads_ 


_P 


html) 


Part 2 


(http 


/ /www 


j avaworld 


com/javaworld/jw 


10 


1998/jw-10 


toolbox_ 


_P 


html) 


Part 3 


(http 


/ /www 


j avaworld 


com/ j avaworld / jw 


11 


1998/jw-11 


toolbox 


_P 


html) 


Part 4 


(http 


/ /www 


j avaworld 


com/ j avaworld / jw 


12 


1998/jw-12 


toolbox_ 


_P 


html) 


Part 5 


(http 


/ /www 


j avaworld 


com/javaworld/jw 


02 


1999/jw-02 


toolbox_ 


_P 


html) 


Part 6 


(http 


/ /www 


j avaworld 


com/ j avaworld / jw 


03 


1999/jw-03 


toolbox_ 


_P 


html) 


Part 7 


(http 


/ /www 


j avaworld 


com/javaworld/jw 


04 


1999/ jw-04 


toolbox_ 


_P 


html) 



Multithreading with the Thread Class 

All Java programs contain at least one thread of execution. From an appli- 
cation perspective, that thread is called main: It is the main thread that 
runs an application's mainO method. When an exception is thrown from the 
main thread and not handled by an application. Exception in thread "main" 
appears as part of the exception message that the default JVM exception 
handler prints. In addition to the main thread, other JVM threads work 
behind the scenes. One example is the garbage collector thread that 
reclaims the memory of objects that are no longer referenced. 



NOTE 

This chapter explores threads in an application context. However, much of what is said 
is applicable to applets. Where threads are concerned, the primary difference between 
those program categories is that applets are not permitted to perform all thread opera- 
tions, for security reasons. Also, the applet's main thread is a Web browser thread, and 
most likely is not named main. 



Additional threads can be introduced into an application by using the 
Thread class (located in the java.lang package). It is important to under- 
stand that objects created from that class are associated with threads: 
Those objects are not threads. If you examine the Thread class, in the SDK 
documentation, you will find constructors and other methods for creating 
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EXAMPLE 



Thread objects, starting threads associated with those objects, and perform- 
ing a variety of basic Thread operations. This chapter explores most of those 
methods. 

CAUTION 

Sun has deprecated several of Thread's methods. That has been done for various rea- 
sons. For example, with some of Thread's deprecated methods, it is possible to lock 
up your program and the JVM. You are strongly encouraged to avoid using deprecated 
methods. In fact, this chapter does not discuss deprecated Thread methods. 

The ThreadDemol appHcation source code in Listing 10.1 introduces the 
Thread class, by creating an application thread that runs concurrently 
(either at the same time on a machine with multiple processors, or almost 
at the same time on a machine with a single processor) with the applica- 
tion's main thread. 

Listing 10.1: ThreadDemol .Java. 

// ThreadDemol . java 

class ThreadDemol extends Thread 
{ 

public void run () 
{ 

for (int i = 0; i < 20; i++) 

System. out. println ("i = " + i); 

} 

public static void main (String [] args) 
{ 

ThreadDemol td1 = new ThreadDemol (); 
td1. start 0; 

for (int i = 0; i < 20; ]++) 

System. out. println {"] = " + j); 

} 

} 

ThreadDemol extends the Thread class, which implies that a ThreadDemol object 
is a kind of Thread object. ThreadDemol 's main() method creates a ThreadDemol 
object and calls the no-argument ThreadDemol ( ) constructor that the compiler 
creates, by default. In turn, that constructor calls its no-argument super- 
class constructor: ThreadO, which initializes the Thread layer of the 
ThreadDemol object. We now have a specialized Thread object — ThreadDemol — 
but not a second independently running thread. To begin that new thread, 
ThreadDemol must call its inherited — from the Thread class — start () method. 
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OUTPUT 



When a thread calls the start ( ) method, a new thread initializes and starts 
running. That initialization doesn't take much time, and start ( ) returns 
almost immediately. Where does that new thread begin execution? The 
answer is a method named run( ). That method is declared in Thread (as an 
empty method) and overridden by a subclass to perform useful work. In 
source code, run( ) is declared with no parameter list and the return type is 
marked with the void keyword (to signify the method returns nothing). 

CAUTION 

After a thread calls start { ) to begin another thread, subsequent calls to start ( ) 
by the thread that first called start ( ) and while the new thread is running, cause 
start 0 to throw an IllegalThreadStateException object. 

When start ( ) returns, the main thread begins executing the For loop state- 
ment that iterates over values of j from 0 through 19. Also, the second 
thread begins executing the run( ) method's For loop statement that iterates 
over values of i from 0 through 19. When the second thread's For loop 
statement ends, its run( ) method completes and that thread terminates. 
When the main thread completes executing its For loop statement, the 
main ( ) method exits, and the main thread terminates. That behavior raises 
an interesting point: When the main thread terminates, and if another 
thread is still running its code, does the entire application terminate before 
that other thread terminates? Unless that other thread is a daemon thread 
(a concept discussed later in this chapter), the application will not termi- 
nate until all of its threads have terminated. 

NOTE 

After a thread returns from its run( ) method and terminates, it cannot be restarted. If 
the thread that originally called start { ) to start the now-terminated thread tries to 
restart that thread by calling start ( ) on the terminated thread's Thread object, 
start 0 returns and the terminated thread remains terminated. 

What kind of output does the ThreadDemol application produce? The follow- 
ing is a portion of that output: 

j = 0 
i = 0 

j = 1 
i = 1 

j = 2 

i = 2 

j = 3 

i = 3 

j = 4 

i = 4 
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The partial output shows that, after the start ( ) method returns, the main 
thread continues before the new thread begins. Although that behavior is 
common, there is the chance that the new thread might start to execute its 
run( ) method before the main thread continues its execution. Also, the out- 
put indicates a mixture of System, out. println( ) method calls from both 
threads. Although the output is interleaved (first j = 0, then i = 0, then j 
= 1, then i = 1 — and so on), that is not always the case. The output could 
just as easily appear in a different order. For example: j = 0 j = 1 j = 2 i 
= 0 i = 1 j = 3 (and so on). 

Because people think in a linear fashion, it is often hard to visualize what 
is happening when learning about threads. For that reason. Figure 10.1 
presents a graph of location versus time that shows the behavior of 
ThreadDemol's main and new threads. 



second thread's 
run() method 
running 

second thread 
initializing 

startO called 

main thread's 
main() method 
running 

main thread 
initializing 



second thread terminated 



A 



main thread terminated 
► 



Time 



Figure 10.1: A location / time graph shows the behavior of ThreadDemol's 
main and new threads, including the moment when the new thread is 
created. 



NOTE 

main() is the main thread's entry point, and run() is a new thread's entry point, 
main ( ) receives an array of command-line arguments, but run ( ) does not receive any 
arguments. To communicate data between the main thread and a new thread, the main 
thread can assign values to static variables. The new thread can then access those 
values by referring to the static variables from its run( ) method. 



Multithreading witli tlie Runnable Interface 

It isn't always possible to subclass Thread. For example, suppose you want 
to introduce multithreading into a class that extends another class. 
Because Java doesn't allow a class to extend more than one additional 
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class, another means is required to introduce multithreading into that 
class: the Runnable interface. 

The java.lang package contains an interface named Runnable. That interface 
declares a single method signature: void run( ). Also, the Thread class speci- 
fies several constructors that include a Runnable parameter. The purpose of 
those constructors is to connect a Runnable object to the Thread API. That 
allows the API to identify the location of the run( ) method when a thread 
starts. 

It is common to use the Runnable interface to add multithreading support to 
applets, for animation or other purposes. Runnable is required because an 
applet's class already extends java. applet. Applet, and it just isn't possible 
to also extend the Thread class. To see what Runnable implementation and 
thread creation based on that interface looks like, check out the source code 
to the ThreadDemo2 applet in Listing 10.2. 

Listing 10.2: ThreadDemo2. java. 
// ThreadDemo2. java 

public class ThreadDe[tio2 extends java. applet .Applet implements Runnable 
{ 

private Thread t; 
private int count; 

public void start () 
{ 

if (t == null) 
{ 

t = new Thread (this) ; 
t. start 0; 

} 

} 



public void run {) 
{ 

while (isActive ()) 

System. out. println (count++); 

} 

} 

When studying ThreadDemo2 source code in Listing 10.2, the first thing to 
note is the implements Runnable clause. That implementation requires a 
class to support Runnable's run() method. The second thing to note is the new 
Thread (this) ; logic in the applet's start ( ) method. (An applet starts its 
execution, by way of its start ( ) method, which is called by a Web browser 
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thread.) That logic invokes the Thread (Runnable target) constructor and is 
legal because the current ThreadDemo2 object's class implements Runnable. 
The presence of keyword this identifies the current ThreadDemo2 object and 
is the connection between a Runnable object (that is, an object whose class 
implements the Runnable interface) that presents a run( ) method and the 
Thread API. That connection is how the Thread API locates the run ( ) 
method when Thread's start ( ) method is called to start another thread. The 
important points to take away from the prior discussion are as follows: 

• A class, whose objects are required to be multithreaded, and which 
already extends a class, must implement the Runnable interface. 

• Implementing the Runnable interface requires the class to implement 
Runnable's public run() method. 

• The Thread(Runnable target) (or other Thread constructor that includes 
a Runnable parameter) must be used to connect the current Runnable 
object, identified by this, with the Thread API: The thread can then be 
started by calling Thread's start () method. 



TIP 

It isn't always easy to determine whether a class should extend Thread or implement 
Runnable. The determination depends on a class hierarchy. Because a class can only 
extend one class, you might consider implementing Runnable, especially in a complex 
program. After all, any or all classes in a class hierarchy can implement Runnable. The 
result is that any object created from any of those classes can be multithreaded. 



Basic Thread Operations 

A casual investigation of the Thread class reveals an assortment of interest- 
ing methods for performing basic thread operations. Some of those methods 
are deprecated (and should not be used). However, other methods are quite 
useful and simplify working with threads. This section explores several of 
Thread's methods. Later (and more appropriate) sections investigate other 
methods. 

Thread Naming 

All threads have names. By default, those names consist of the word Thread 
followed by a hyphen character ( -) followed by an integer number, starting 
at 0. You can introduce your own names by working with the setName ( ) and 
getNameO methods. Those methods make it possible to attach a name to a 
thread and retrieve a thread's current name, respectively. That name can 
be useful for debugging purposes. 
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The setName( ) method takes a String argument that identifies a thread. 
Similarly, the getName( ) method returns that name, as a String. The 
ThreadDemoS source code in Listing 10.3 demonstrates those methods. 

Listing 10.3: ThreadDemoS . Java. 
// ThreadDemoS. java 



class MyThread extends Thread 
{ 

MyThread (String name) 
{ 

setName (name); 

} 

public void run () 
{ 

System. out. println ("Name = " + getName ()); 

for (int i = 0; i < 20; i++) 

System. out. println ("i = " + i); 



} 



class ThreadDemoS extends Thread 
{ 

public static void main (String [] args) 
{ 

MyThread mt = new MyThread ("My Thread"); 
mt. start (); 

for (int i = 0; i < 20; ]++) 

System. out. println ("j = " + j); 



} 

ThreadDemos's main( ) method creates a MyThread object and initializes that 
object by passing My Thread to MyTh read's constructor. In turn, that construc- 
tor calls setName ( ) to assign My Thread as the name of a MyThread thread. 
Later, after the new thread has started, it prints out that name in its run( ) 
method, by first calling getName ( ) to retrieve that name. 

Four of Thread's constructors support initializing Thread objects with names. 
Those constructors include Thread (String name) and Thread(Runnable target, 
String name). The following code fragment initializes a MyThread object with 
a name, by calling the Thread(String name) constructor instead of by calling 
setName(): 
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MyThread (String name) 
{ 

super (name); 

} 

Thread Sleeping 

Sometimes, it is necessary to pause for a certain length of time before 
allowing the current thread to continue its execution. For example, when 
generating an animation sequence, the idea is to display an image, pause, 
display another image, pause, and so forth. Without the pause, it is quite 
likely that the images that make up the animation will be displayed so fast 
as to make it difficult (if not impossible) to see the animation. Thread comes 
to the rescue with two sleep () methods. Either method pauses the current 
thread, when called. 

Thread's sleep (long millis) method pauses the current thread for a specific 
number of milliseconds, as indicated by the millis parameter. In contrast. 
Thread's sleep(long millis, int nanos) method pauses the current thread 
for a specific number of milliseconds plus nanoseconds, as indicated by 
millis and nanos, respectively. Many platforms that implement a JVM do 
not support a resolution as small as a nanosecond (or even a millisecond). 
In such cases, the number of nanoseconds is rounded to the nearest mil- 
lisecond, and the number of milliseconds is rounded to the smallest resolu- 
tion supported by a platform. 

The earlier ThreadDemol application's threads interleaved their output. By 
inserting a call to Thread. sleepO, the ThreadDemo4 source code in Listing 
10.4 gives the new thread a chance to complete before the main thread 
enters its For loop statement. 

Listing 10.4: ThreadDemo4. java. 
// ThreadDeno4. java 

class ThreadDemo4 extends Thread 
{ 

public void run () 
{ 

for (int i = 0; i < 20; i++) 

System. out. println ("i = " + i); 

} 

public static void main (String [] args) 
{ 

ThreadDemo4 td4 = new ThreadDemo4 (); 
td4. start 0; 
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Listing 10.4: continued 
try 
{ 

Thread. sleep (2000); 

} 

catch (InterruptedException e) 

{ 

} 

for (int i = 0; i < 20; j++) 

System. out. println {"] = " + j); 

} 

} 

The main thread sleeps for 2000 milliseconds (2 seconds) before continuing 
with its execution. By that time, the new thread is finished. Although that 
works as indicated on a tested platform, you might want to increase the 
delay on your platform to observe the same result. That is due to different 
operating systems and the way threading works under each operating sys- 
tem, different processor speeds, and other factors. 

NOTE 

When sleep 0 is called, the processor puts the current thread to sleep and runs 
another thread. The processor determines when the sleep time is finished and wakes 
up the sleeping thread when the time expires. However, it is possible that some 
other thread might interrupt a thread that is sleeping. In that case, the processor 
prematurely wakes up the sleeping thread. In turn, the sleep{ ) method throws an 
InterruptedException object instead of returning normally. To learn more about 
handling that kind of exception, read the Java Developer Connection TechTip Handling 
Those Pesky InterruptedExceptions (http: / /developer . java. sun . com/developer/ 
TechTips/2000/tt0425.html#tip2). 




EXAMPLE 



Deteriviining Thread Alive Status 

After Thread's start ( ) method has been called, a certain period of time 
elapses before run( ) is called. That time is used for thread initialization. 
Also, after run( ) returns, a certain period of time elapses before the JVM 
cleans up after the thread. A thread is considered to be alive just before 
run( ) is called and continues to be alive until just after run( ) returns. 
Thread's isAlive( ) method returns true during that interval. Otherwise, 
false returns. 

Why would you want to call isAlive( )? You can use that method to deter- 
mine whether a thread has stopped. For example, suppose a thread, whose 
object is referenced by th, is running. Now, suppose that another thread x 
wants to make sure that the thread is finished, so that x can access infor- 
mation produced by the other thread. The following code fragment shows 
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how X (the current thread, in that case) might wait for the other thread to 
terminate: 

while (th.isAlive ()) 
try 
{ 

Thread. sleep (100); 

} 

catch (InterruptedException e) 
{ 
} 

th = null; 

The code fragment uses a While loop statement to keep checking whether 
the thread, whose object is referenced by th, is alive. Rather than unneces- 
sarily tie up the processor with repeated checking, the thread regularly 
puts itself to sleep for 100-millisecond periods. 

Thread Joining 

The isAlive( ) and looping technique is quite useful. In fact, that technique 
is the basis for Thread's three overloaded ioin() methods. A thread calls a 
ioin( ) method when it must wait for another thread to complete: The wait- 
ing thread is "joining" with a previously started thread (also known as a 
"forked" thread, by Unix aficionados). The no-argument join() method sim- 
ply waits until another thread is no longer alive, which could be an indefi- 
nite period of time. That is why the other ioin( ) methods include a 
time-out provision: If a thread has not completed in the amount of time 
specified by the time-out, the waiting thread stops waiting. 

NOTE 

Because it is possible to interrupt a thread that is waiting to join with another thread, 
the join() methods are capable of throwing InterruptedException objects. 

The transcendental number 2.71828..., represented by math symbol e, can 
be calculated by using the formula i/0! + i/i!+i/2! + ... (where 
! means factorial). Suppose we decide to create an application that per- 
forms that calculation in a new calculation thread. When the calculation 
thread completes, we would like the main thread to print the result. By 
calling j Din ( ) , the main thread waits until the calculation completes before 
printing the result. The ThreadDemoS application, whose source code appears 
in Listing 10.5, does just that. 




EXAMPLE 
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Listing 10.5: ThreadDemoS. Java. 
// ThreadDemoS. java 

class ThreadDemoS extends Thread 
{ 

double e; 

public void run () 
{ 

for (int i = 0; i < 20; i++) 
e += 1 .0 / factorial (i) ; 

System. out. println ("Done"); 

} 

int factorial (int n) 
{ 

if (n == 0) 
return 1 ; 

else 

return n * factorial (n - 1); 

} 

public static void main (String [] args) 
{ 

ThreadDemoS tdS = new ThreadDemoS (); 
tdS. start 0; 

try 
{ 

tdS.join 0; 

} 

catch ( InterruptedException e) 
{ 
} 

System. out. println ("e = " + tdS.e); 

} 

} 

ThreadDemoS produces the following output: 
Done 

e = 2.71828183S12S1SS4 
OUTPUT 
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NOTE 

A thread can call the isAliveO and ioin() methods on Itself. However, neither call 
makes any sense. If the current thread calls isAlive { ) , that method always returns 
true. If the current thread calls join( ) , the thread Is attempting to join with itself. In 
other words, the current thread Is waiting until It completes. You guessed It: The current 
thread waits forever! By the way, to obtain access to the current thread's Thread object, 
call Thread's currentThread( ) method. 




EXAMPLE 



Thread Enumeration 

The Thread class provides a pair of methods that work together to enumer- 
ate references to Thread objects (corresponding to all active threads in a pro- 
gram): activeCount( ) and enumerate(). The activeCount ( ) method returns an 
integer that specifies the number of active threads. That value is only an 
estimate and is used to size an array of Thread references. After the array is 
sized, it can be passed as an argument to the enumerate ( ) method. That 
method fills the array with references to all active threads' Thread objects. 
The integer returned by enumerate ( ) identifies the actual number of Thread 
references stored in the array. That return value should be used instead of 
activeCount ( )'s return value, when examining the returned references in a 
loop. 

When is a thread considered active? That is not an easy question to answer. 
Various sources suggest that a thread is considered to be active after its 
Thread object is created (even if the corresponding thread has not been 
started). However, in practice, it appears that a thread must be started to 
be considered active. Regardless, a thread continues to be active until it 
returns from its run( ) method. At some point between a Thread object being 
created and started, its reference is added to an internal enumeration list. 
That reference is removed when the run( ) method completes. 

To demonstrate activeCount ( ) and enumerate (), the ThreadDemo6 source code 
in Listing 10.6 starts a new thread in addition to the main thread. Those 
threads are then enumerated. 

Listing 10.6: ThreadDemoe. Java. 
// ThreadDemo6. java 

class ThreadDemoe extends Thread 
{ 

public void run () 
{ 

for (int i = 0; i < 20; i++) 

System. out. println ("i = " + i); 

} 
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Listing 10.6: continued 

public static void main (String [] args) 
{ 

ThreadDemoe td6 = new ThreadDeno6 (); 
td6. start 0; 

Thread [] threads = new Thread [Thread. activeCount ()]; 
int n = Thread . enumerate (threads); 

for (int i = 0; i < n; i++) 

System. out. println (threads [i].toString ()); 

} 

} 

When you run the program, you'll see Thread [main, 5, main] and 
Thread[Thread-0,5,main] interspersed among the output. However, if 
you comment out the line containing td6 . start ( ) ; , you will most likely 
not see Thread[Thread-0,5,main]. If you don't see Thread[Thread-0,5,main] 
when td6 . start ( ) ; is commented out, that proves that, on your platform, 
a thread is not active until its start ( ) method is called. 

What does the information between square brackets mean? For 
Thread [main, 5, main], the leftmost main names the thread, 5 identifies its 
priority, and the rightmost main identifies the thread group to which the 
main thread belongs. Similarly, for Thread[Thread-0,5,main], Thread-0 
names the thread, 5 is the thread's priority, and main is its thread group. 
You will learn more about those concepts later in this chapter. 



CAUTION 

Do not rely on activeCount ( ) 's return value when iterating over an array of active 
Thread references. Instead, use enumerate ( )'s return value. If you rely on 
activeCount ( ) 's return value, your program might end up throwing a 
NullPointerException object. That happens when enumerate () does not assign 
Thread references to all elements in the array sized by activeCount () 's return value, 
and those elements not assigned Thread references contain null references. 



Thread Debugging 

The Thread class provides some support for debugging, by way of its 
dumpStackO and toString() methods. When called, the dumpStack() method 
prints a stack trace of the current thread. (If you examine the source 
code for that method, you will discover new Exception ("Stack trace"). 
printStackTrace ().) The toStringO method, when called, returns a string 
representation of the current Thread object. That representation is in the 
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EXAMPLE 



form Threacl[thread-nartie, priority, thread-group]. Later in this chapter, you 
will learn about priority and thread groups. 

User Threads and Daemon Threads 

Java regards threads as user threads or daemon threads. User threads are 
the default. When the main thread terminates, the JVM checks to see 
whether any other user thread is running. If so, the JVM does not termi- 
nate the application. On the other hand, if the JVM detects only daemon 
threads, the application terminates. 

Daemon threads are designed as low-level background threads that perform 
useful work. However, it is not essential that they be allowed to complete 
before an application terminates. One example of a daemon thread is the 
garbage collector thread. 

To create a daemon thread, call Thread's setDaemon( ) method with a Boolean 
true argument value. That method must be called before Thread's start ( ) 
method. After start ( ) is called, subsequent setDaertion( ) calls result in 
lllegalThreadStateException objects being thrown. To determine whether a 
Thread object is associated with a daemon thread, call Thread's isDaemon() 
method. 

Timers 

An application sometimes needs to run a task, either once at some future 
time (which is known as a one-shot task) or at regular intervals. Although 
it is possible to use the Thread class to achieve either objective, many devel- 
opers find working with Thread — in that capacity — to be burdensome. What 
is needed is some kind of timer mechanism. Sun eventually recognized the 
need for timers and included timer support — by way of the java.util. Tinier 
and java.util.TimerTask classes — when it introduced version 1.3 of the Java 
2 SDK. Timer objects are associated with threads that run tasks for either 
one-shot or repeated execution, and TimerTask objects represent those tasks. 

A good way to familiarize yourself with Timer and TimerTask is to study an 
example. The TimerDemo source code in Listing 10.7 demonstrates using 
Timer and TimerTask to run a one-shot task and a repetitive task. 

Listing 10.7: TimerDemo. java. 
// TimerDemo. java 

import java.util.*; 



class TimerDemo 
{ 
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Listing 10.7: continued 

public static void main (String [] args) 
{ 

Timer t = new Timer (true); 

t. schedule (new OneShotTask (), 1000); 

System. out. println ("main thread sleeping"); 

try 
{ 

Thread. sleep (3000); 

} 

catch ( InterruptedException e) 

{ 

} 

System. out. println ("main thread waking up"); 
Timer t2 = new Timer (); 
t2. schedule (new RepeatedTask (), 1000, 500); 
System. out. println ("main thread terminating"); 

} 

} 

class OneShotTask extends TimerTask 
{ 

public void run () 
{ 

System. out. println ("OneShotTask running"); 

} 

} 

class RepeatedTask extends TimerTask 
{ 

int i; 

public void run () 
{ 

System. out. println ("RepeatedTask running"); 

if (++i == 5) 

{ 

System. out. println ("cancelling timer thread"); 
cancel (); 

System. out. println ("timer thread terminating"); 



12 71710_CH10 11/21/01 12:28 PM Page 388 




388 Chapter 10: Threads 



OUTPUT 



Listing 10.7: continued 

System. exit (0); 

} 

} 

} 

When run, TimerDemo produces the following output: 

main thread sleeping 
OneShotTask running 
main thread waking up 
main thread terminating 
RepeatedTask running 
RepeatedTask running 
RepeatedTask running 
RepeatedTask running 
RepeatedTask running 
cancelling timer thread 
timer thread terminating 

TimerDemo's source code illustrates several things about the Timer API. 
To begin, Timer objects are initialized by calling one of two constructors: 
TimerO or Timer(boolean isDaemon). Timer() initializes a Timer object that's 
associated with a non-daemon thread. (An application does not terminate if 
the timer's thread is still alive.) On the other hand, the Timer (boolean 
isDaemon) constructor makes it possible to associate a timer with a daemon 
thread. (When the main thread terminates, so does the timer's thread.) 

After a Timer object has been created, call one of its schedule () methods to 
schedule a timer task for one-shot or repeated execution. Those methods 
require a reference to either a TimerTask object or an object created from a 
TimerTask subclass. (Typically, you will subclass TimerTask, because objects 
created from TimerTask accomplish nothing useful.) The schedule () methods 
also allow an initial delay and an interval to be specified. That delay occurs 
before a task executes, and the interval decides the frequency of repeated 
execution. 

TimerTask subclasses override TimerTask's run() method. That method serves 
as a task's entry-point. When a task is repeatedly executing, that task can 
be canceled by calling TimerTask's cancel() method. After a task is canceled, 
it will never run again. 

TIP 

A lot more could be said about Timer and TimerTask. To further explore those useful 
classes, read the Java Developer Connection TechTIp, Using Timers To Run Recurring 
or Future Tasks on a Background Thiread (http: / /developer, j ava. sun . com/ 
developer/TechTips/2000/tt0530.html#tip2). 
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Synchronization 



This chapter's previous thread examples have demonstrated threads that 
are more or less independent. In other words, those threads have either not 
accessed shared data or have accessed shared data under tight control. For 
example, in the ThreadDemoS application in Listing 10.5, the main thread 
accessed variable e only after the calculation thread had finished. However, 
when multiple threads have uncontrolled access to shared data, the data 
can corrupt. 



NOTE 

By "shared data," this chapter is referring to variables that can be simultaneously 
accessed by multiple threads. Those variables are either instance fields or class fields. 
Shared variables are never local variables or parameters, because each thread gets its 
own copy of local variables and parameters. 



Consider a database management system (DBMS) that controls access to a 
database of employee information. Suppose a pair of remote programs con- 
tact that DBMS at about the same time and that the DBMS program cre- 
ates a pair of threads, where each thread handles the needs of each remote 
program. Suppose both threads, on behalf of their respective remote pro- 
grams, are to update the same employee record. To keep things simple, let's 
assume that an employee record consists of two fields: name and salary. 



NOTE 

Field is an example of an overloaded computer science term: Field is commonly used 
to refer to either a class or object variable or to a portion of a file's record. (Record 
refers to a sequence of fields that describe a single entity, such as an employee, in a 
file.) 



If both threads are allowed uncontrolled access to an employee record, the 
following scenario could occur: The first thread could set the employee's 
name field to John Smith. Before the first thread sets the salary field to 
30000, the second thread intervenes and sets the name field to Alice Jones 
and the salary field to 40000. The second thread terminates (because it has 
finished its work), and the first thread continues, by setting the salary field 
to 30000. We now have an employee record with a name field consisting of 
Alice Jones and a salary field consisting of 30000, which is obviously incor- 
rect: The employee record has become corrupt. To see that behavior in 
action, check out the SyncDemol source code in Listing 10.8. 
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Listing 10.8: SyncDemol .Java. 
// SyncDemol .java 

class Record 
{ 

private String name; 
private double salary; 

void update (String name, double salary) 
{ 

this. name = name; 



ry 

Thread. sleep ((int) (Math. random () * 100)); 
catch (InterruptedException e) 



this. salary = salary; 

} 

void print () 
{ 

Thread t = Thread. currentThread (); 

System. out. println (t.getName () + ": name = " + name 
+ " , salary = " + salary) ; 

} 

} 

class SyncDemol extends Thread 
{ 

static Record r = new Record (); 

public static void main (String [] args) 
{ 

SyncDemol x = new SyncDemol ("x"); 
SyncDemol y = new SyncDemol ("y"); 

x. start 0; 
y. start (); 

} 



SyncDemol (String name) 
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Listing 10.8: continued 
{ 

super (name); 

} 

public void run {) 
{ 

while (true) 
{ 

r. update (getName (). equals ("x") ? "John Smith" : 

"Alice Jones" , 
getName (). equals ("x") ? 30000.0 : 

40000.0) ; 

r. print (); 

} 

} 

} 

SyncDemol simulates the aforementioned DBMS scenario. It performs that 
simulation by introducing a Record object — for holding an employee's 
information — and a pair of threads that update fields contained in that 
object. If you run SyncDemol, you'll see output similar to the following: 

y: name = Alice Jones, salary = 40000.0 
x: name = Alice Jones, salary = 30000.0 
x: name = John Smith, salary = 30000.0 
y: name = John Smith, salary = 40000.0 

The output shows a pair of problems with SyncDemol. First, John Smith is not 
always associated with a salary value of 30000.0, and Alice Jones is not 
always associated with a salary value of 40000 . 0. Second, it is thread x's 
responsibility to print the values of John Smith and 30000.0; and thread y's 
responsibility to print the values of Alice Jones and 40000.0. However, 
either thread is capable of printing any combination of name and salary. 

SyncDemol's problems arise from a pair of race conditions involving threads x 
and y. (A race condition is the act of two or more threads attempting to 
access the same data at the same moment.) The first race condition 
involves the update ( ) method call in the run( ) method. When called, that 
method passes both a name value and a salary value to the Record object 
referenced by r. Consider the following scenario: The first getName ( ) . equals 
( "x" ) expression returns true. That means John Smith is selected as the first 
argument. After that selection, thread x pauses its execution so that thread 
y can run. Thread y evaluates the second getName ( ) . equals ( "x" ) expres- 
sion and chooses 40000.0 as the second update ( ) argument. We now have a 
situation where both John Smith and 40000.0 will be assigned to Record's 
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name and salary fields. That is incorrect. The second race condition involves 
the interplay between the update ( ) and print ( ) methods. Consider the 
following scenario: One thread has just executed Thread t = Thread. 
currentThread ( ) ; (in the print ( ) method) and is pausing its execution so 
the other thread can run. The other thread executes update ( ) and pauses so 
the first thread can run. The first thread accesses its name and prints that 
name along with the contents of the name and salary fields, as set by the 
other thread. For example, either x prints with Alice Jones (instead of 
John Smith) or y prints with John Smith (instead of Alice Jones). 

Race conditions arise when the order of execution among two or more 
threads affects the outcome of a program's execution. To prevent a race con- 
dition, a thread must be able to complete its manipulations of shared data 
before another thread can access that data. That activity is the focus of syn- 
chronization. 



NOTE 

You might be curious about Thread. sleep ()'s purpose in SyncDemol 's source code. 
That method call briefly puts a thread to sleep between its name and salary field 
assignments. That is done to give the other thread a chance to run and call update ( ) 
while a thread is sleeping. The whole idea is to show a race condition. Without 
Thread . sleep{ ) , the race condition still exists, but the chance of that condition result- /i^ 
ing in corrupt data is lessened, which is not good for demonstration purposes. (The ^ 
execution of this. name = name; immediately followed by this. salary = salary; 
occurs very quickly, and the likelihood of one thread not being able to perform both 
assignments before having to wait for another thread is remote.) Also, to simulate a 
real execution environment, a thread should sleep for a random amount of time. If the 
thread always sleeps for the same amount of time, the race condition might not be 
demonstrated. Math . random( ) , which is further explored in Chapter 14, returns a ran- 
dom number between 0.0 and (almost) 1.0. The returned value is multiplied by 100 
and converted to an integer, so that the final value ranges between 0 and 99 
(inclusive). 



Locks and Blocks 

Code that manipulates shared data is known as a critical section. Some 
means is required to synchronize thread access to a critical section so that 
multiple threads do not partially modify each other's manipulations of that 
shared data. In 1974, computer scientist C.A.R. Hoare introduced monitors 
as a tool for achieving synchronized access to critical sections. A monitor is 
nothing more than a locking mechanism. To achieve monitor-style synchro- 
nization, Java associates each object with a lock. Behind the scenes, that 
lock is used with synchronized blocks. 

A synchronized block is either a block of code within a method or the entire 
method. To synchronize a block of code within a method, the following 
syntax must be specified: 
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'synchronized' '(' objectldentifier ')' 
'{' 

// critical section 

'}■ 

The synchronized keyword is followed by what appears to be an argument 
list consisting of a single argument: objectldentifier. objectldentifier 
identifies the object whose associated lock is used to provide synchronized 
access to the critical section found between { and }. 

How does that construct control access to a critical section? When a thread 
executes synchronized, it is only allowed to enter the critical section pro- 
vided that no other thread has acquired the lock associated with 
objectldentifier. If the lock has not been acquired, the thread acquires the 
lock and enters the critical section. Otherwise, because a thread is cur- 
rently executing the critical section, the new thread is forced to wait until 
that lock is released. The lock is released when the thread holding the lock 
exits the critical section, whether or not that exit takes place by way of an 
exception. 

The two race conditions in the previous SyncDemol application can be elimi- 
nated by wrapping both update ( ) and print ( ) method calls in a synchro- 
nized block. The SyncDemo2 source code in Listing 10.9 demonstrates that. 

Listing 10.9: SyncDenio2. java. 
// SyncDemo2. java 

class Record 
{ 

private String name; 
private double salary; 

void update (String name, double salary) 
{ 

this. name = name; 
ry 

Thread. sleep ((int) (Math. random () * 100)); 
catch (InterruptedException e) 



this. salary = salary; 

} 
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Listing 10.9: continued 
void print () 
{ 

Thread t = Thread. currentThread (); 

System. out. println (t.getName {) + ": name = " + name 
+ " , salary = " + salary) ; 

} 

} 

class SyncDemo2 extends Thread 
{ 

static Record r = new Record (); 

public static void main (String [] args) 
{ 

SyncDemo2 x = new SyncDemo2 {"x"); 
SyncDemo2 y = new SyncDemo2 ("y"); 

X. start 0; 
y. start (); 

} 

SyncDemo2 (String name) 
{ 

super (name); 

} 

public void run () 
{ 

while (true) 
{ 

synchronized (r) 
{ 

r. update (getName (). equals ("x") ? "John Smith" : 

"Alice Jones" , 
getName (). equals ("x") ? 30000.0 : 

40000.0) ; 

r. print (); 

} 



} 

} 



SynoDemo2 declares a synchronized block in its run() method. That block 
uses the lock associated with the object referenced by r. Only one thread at 
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a time can enter the block and execute update ( ) followed by print ( ) . That 
ensures both Record fields are set to the appropriate values, and that 
print ( ) displays the appropriate thread name with the thread's associated 
data. 

■ --^ Version 1.4 of Java 2 Standard Edition introduces a static holdsLock( Object 
^4 0 ) method that returns a Boolean true value if the current thread holds 
the lock on the object referenced by o. For example, you could specify 
System. out. println (Thread . holdsLock (r)); in the synchronized block of 
SyncDemo2's run() method. Each time System. out. println (Thread. holdsLock 
(r) ) ; was called, true would print because the current thread holds the lock 
associated with the object referenced by r. However, if you were to change r 
to this, as in System. out. println (Thread . holdsLock (this) ) ;, false would 
print; the current thread does hold the lock associated with the current 
SyncDemo2 object. 

CAUTION 

It is important that threads work with the same lock; otherwise, there will be no syn- 
chronization. That implies you must choose an object that's common to multiple 
threads. For example, if you look at SyncDemo2, you'll notice that the object used for 
synchronization is a statically declared Record object. If you were to substitute keyword 
this for r in synchronized (r), each thread would acquire a separate lock. As a 
result, those threads would both be allowed access to the critical section, and the pre- 
viously described race conditions would reappear. 

It is usually a good idea to sjnichronize on only a block of code within a 
method. By keeping the size of a critical section to a small portion of the 
method, you minimize thread waiting time, which benefits performance. Also, 
by reducing critical section size, it is less likely that a program's threads will 
deadlock — a situation described later in this chapter. However, there are 
times when an entire method is a critical section. In those situations, you can 
affix keyword synchronized to a method header, for example: synchronized 
void print (). 



Object Locks and Class Locks 

Java recognizes two kinds of locks: object locks and class locks. An object 
lock is associated with either a synchronized block or an instance synchro- 
nized method. However, if the thread wants to enter a static synchronized 
method, it must acquire a class lock. The class lock is really an object lock 
associated with the Class object. In turn, that object is associated with the 
class in which the static synchronized method is declared. 

When it comes to synchronizing at the method level, there are a couple of 
things to consider about object locks and class locks: 
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• Object locks and class locks are two different kinds of locks: They are 
not related. Those locks can be acquired and released independent of 
each other. An instance synchronized method calling a static synchro- 
nized method acquires both locks. 

• A static synchronized method that has access to an object reference 
can call that object's synchronized method(s) or use the object to lock a 
synchronized block. The thread acquires the class lock when it calls 
the static synchronized method and then acquires the object lock for 
the specific object. 

The following code fragment demonstrates where object and class locks are 
acquired for instance and static synchronized methods: 

class LockDemo 
{ 

synchronized static void staticMethod (LockDemo Id) 
{ 

// Class lock acquired at this point. 

Id.instancenethod (); 

synchronized (Id) 
{ 

// Object lock acquired at this point, in addition to the 
// previously-acquired class lock. 

} 

} 

synchronized void instanceMethod () 
{ 

// Object lock acquired at this point, in addition to the 
// previously-acquired class lock when this method is called 
// from StaticMethod ( ) . 

} 

} 

Deadlock 

When multiple threads compete for the same set of locks, deadlock can 
occur. Threads deadlock when each thread holds a lock that another thread 
needs before it can proceed into a critical section. Because no threads can 
proceed, they are forced to wait. 

\ I / The DeadLockDemo source code in Listing 10.10 demonstrates a deadlock 
01 scenario. 



EXAMPLE 
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Listing 10.10: DeadLockDemo.java. 
// DeadlockDeno. Java 

class DeadlockDemo 
{ 

public static void main (String [] args) 
{ 

UseShared s1 = new UseShared {"x"); 
UseShared s2 = new UseShared ("y"); 

si. start 0; 
s2. start 0; 

try 
{ 

sLjoin {); 
s2.ioin 0; 

} 

catch ( InterruptedException e) 

{ 

} 

System. out. println ("bye"); 

} 

} 

class Shared 

{ 

} 

class UseShared extends Thread 
{ 

static Shared s1 = new Shared (), s2 = new Shared (); 

UseShared (String name) 
{ 

setName (name); 

} 

public void run () 
{ 

for (int i = 0; i < 100; i++) 
{ 

if (getName (). equals ("x")) 
methodi {); 

else 

method2 (); 
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Listing 10.10: continued 
try 
{ 

Thread . sleep ((int) Math. random () * 100); 

} 

catch {InterruptedException e) 

{ 

} 

} 

} 

void methodi () 
{ 

synchronized (s1) 
{ 

System. out. println ("methodi: si"); 

synchronized (s2) 
{ 



System. out. println ("methodi: s2"); 

} 




void method2 () 
{ 

synchronized (s2) 
{ 

System. out. println ("method2: s1"); 

synchronized {s1) 
{ 

System. out. println ("method2: s2"); 

} 

} 

} 

} 

When you run DeadlockDemo, you probably will never see the main thread 
print bye. (If you see bye, consider increasing the limit value in run( )'s For 
loop statement from 100 to a larger number.) The word bye does not appear 
because of deadlock. 

How does deadlock occur in the program? Consider the following scenario: 

Thread x has entered methodi () and is executing System. out. println 

( "methodi : si " ) ; . At that point, thread x has acquired the lock associated 
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with the object referenced by si . Thread x pauses, and thread y runs. 
Thread y enters niethocl2 ( ) and is executing System . out . println ( " [iiethocl2 : 
si " ) ; . At that point, thread y has acquired the lock associated with the 
object referenced by s2. Now, thread y pauses and thread x continues to 
run. Thread x tries to enter the critical section prefixed by synchronized 
(s2) and is forced to wait because thread y holds the lock associated with 
the object referenced by s2. Thread y starts to execute and tries to enter the 
critical section prefixed by synchronized (si ). However, thread y is forced to 
wait because thread x holds the lock associated with the object referenced 
by si. Both threads are deadlocked. 

How do you deal with deadlock? That is not an easy problem to solve. In 
fact, there is nothing the JVM can do to either prevent or detect deadlock: 
It is your responsibility to ensure that situation does not occur. Carefully 
analyze your program's critical sections and look for possibilities where 
multiple threads might acquire each other's locks and not proceed until the 
other threads release their locks. 

Waiting and Notification 

In addition to each object having a lock that can be acquired and released, 
each object also provides a waiting and notification mechanism for threads. 
With that waiting and notification mechanism, one thread requires that a 
certain condition exists before it can proceed and assumes another thread 
will create that condition. 

The waiting and notification mechanism manifests itself through a private 
waiting area (for threads) that every object establishes and through the 
various methods that every object inherits from class Object. A call to 
Ob j ect's wait ( ) method causes a thread to wait for the condition, whereas a 
call to Object's notify ( ) method notifies a waiting thread that the condition 
has been created (without identifying the condition). 

The wait ( ) and notif y ( ) methods are not a replacement for the synchronized 
keyword: Those methods work in partnership with locks. If either method is 
called from a non-synchronized block or method, or is called from such a block/ 
method but does not own the object's lock, an lllegalMonitorStateException 
object is thrown. The reason for that requirement is that a race condition 
exists in those methods, and it cannot be handled properly without the use 
of synchronized. The race condition works as follows: Thread x tests a condi- 
tion and realizes that it must wait. Thread y sets the condition and calls 
the notify ( ) method. Because thread x is not yet waiting, nothing happens. 
Thread x now waits, by calling wait( ). Because notify( ) was already called, 
thread x will wait indefinitely. By enforcing the rule that wait ( ) and 
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notify 0 can be called only from a synchronized context, that race condition 
cannot occur. 

One situation that demonstrates the need for a waiting and notification 
mechanism involves a producer-consumer relationship. A producer produces 
an item, and that item is consumed by a consumer. The producer cannot 
produce an item before the first item is consumed, and a consumer cannot 
consume the item before it is produced. Those restrictions prevent a pro- 
ducer from producing multiple items before even one of those items is con- 
sumed. Similarly, they prevent a consumer from consuming more than one 
item when there is only one item to be consumed at a time. For a first crack 
at modeling that scenario, examine the PCi application source code in 
Listing 10.11. 

Listing 10.11: PC1 . java. 
// PCI.java 

class PC1 
{ 

public static void main (String [] args) 
{ 

Shared s = new Shared (); 
Producer p = new Producer (s); 
Consumer c = new Consumer (s); 
p. start 0; 
c. start 0; 

} 

} 

class Shared 
{ 

private int s = -1 ; 
private boolean anyMoreData = true; 

void setShared (int s) { this.s = s; } 
int getShared () { return s; } 
boolean isAnyMoreData () { return anyMoreData; } 
void setAnyMoreData (boolean b) { anyMoreData = b; } 

} 

class Producer extends Thread 
{ 

private Shared s; 




EXAMPLE 



Producer (Shared s) 
{ 
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Listing 10.11: continued 
this.s = s; 

} 

public void run {) 
{ 

for (int i = 0; i < 10; i++) 
{ 

try 
{ 

Thread. sleep ((int) (Math. random () * 4000)); 

} 

catch (InterruptedException e) {} 
s.setShared (i); 

System. out. println (i + " produced by producer."); 

} 

s.setAnyMoreData (false); 

} 

} 

class Consumer extends Thread 
{ 

private Shared s; 

Consumer (Shared s) 
{ 

this.s = s; 

} 

public void run () 
{ 

while (s.isAnyMoreData ()) 
{ 

try 
{ 

Thread. sleep ((int) (Math. random () * 4000)); 

} 

catch (InterruptedException e) {} 

System. out. println (s.getShared () + " consumed by consumer."); 

} 

} 

} 
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PCI has no race conditions. That might seem surprising when you consider 
the synchronized keyword is not specified as part of any method declaration 
in the Shared class. The reason that synchronized is not needed for Shared's 
methods has to do with those methods executing atomic code. For example, 
setAnyMoreData( ) executes anyMoreData = b;. That code is considered to be 
atomic — a word that traditionally meant indivisible, even though it is now 
known that atoms are divisible into subatomic particles — ^because the JVM 
will not allow a thread to pause before the assignment completes. That 
atomic capability comes into play only when assigning values of some (non- 
long integer or non-double precision floating-point) primitive type to a vari- 
able of the same type. Despite the fact that PCI has no race conditions, it 
does have some problems, as shown in the following output: 
..^ C_ consumed by consumer. 
c^^B^ ® produced by producer. 

0 consumed by consumer. 

1 produced by producer. 

OUTPUT -I consumed by consumer. 

1 consumed by consumer. 

2 produced by producer. 

3 produced by producer. 

3 consumed by consumer. 

4 produced by producer. 

5 produced by producer. 

6 produced by producer. 
6 consumed by consumer. 

6 consumed by consumer. 

7 produced by producer. 

8 produced by producer. 

9 produced by producer. 
9 consumed by consumer. 

First, -1 is not a valid item. How can a consumer consume an item before it 
is produced? Second, the consumer is allowed to consume item 1 twice. 
Third, item 2 is never consumed. Although not shown, another problem is 
producing the same item multiple times before it is consumed. 

To solve those problems, you cannot think only in terms of the synchronized 
keyword and locks. The only way to solve that problem is to incorporate the 
waiting and notification mechanism, which is exactly what the PC2 applica- 
tion source code in Listing 10.12 accomplishes. 




EXAMPLE 



Listing 10.12: PC2 . j ava. 
// PC2.iava 



class PC2 
{ 
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Listing 10.12: continued 

public static void main (String [] args) 
{ 

Shared s = new Shared (); 
Producer p = new Producer (s); 
Consumer c = new Consumer (s); 
p. start 0; 
c. start (); 

} 

} 

class Shared 
{ 

private int s = -1 ; 

private boolean anyMoreData = true; 

private boolean writeable = true; 

synchronized void setShared (int s) 
{ 

while (Iwriteable) 
try 
{ 

wait 0; 

} 

catch ( InterruptedException e) {} 

this.s = s; 
writeable = false; 
notify 0; 



synchronized int getShared () 
{ 

while (writeable) 
try 
{ 

wait 0; 

} 

catch (InterruptedException e) { } 

writeable = true; 
notify 0; 

return s; 

} 
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Listing 10.12: continued 

boolean isAnyMoreData () { return anyMoreData; } 
void setAnyMoreData (boolean b) { anyMoreData = b; } 

} 

class Producer extends Thread 
{ 

private Shared s; 

Producer (Shared s) 
{ 

this.s = s; 

} 

public void run () 
{ 

for (int i = 0; i < 10; i++) 
{ 

try 

{ 

Thread. sleep ((int) (Math . random () * 4000)); 

} 

catch (InterruptedException e) {} 
s.setShared (i); 

System. out. println (i + " produced by producer."); 

} 



s. setAnyMoreData (false); 



} 



class Consumer extends Thread 
{ 

private Shared s; 

Consumer (Shared s) 
{ 

this.s = s; 

} 

public void run () 
{ 

while (s. isAnyMoreData ()) 
{ 

try 
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Listing 10.12: continued 
{ 

Thread. sleep ((int) (Math. random () * 4000)); 

} 

catch (InterruptedException e) {} 

System. out. println (s.getShared () + " consumed by consumer. 



} 

PC2 introduces wait() and notify (). Those methods are called from Shared's 
setShared( ) and getShared( ) methods, which now must be synchronized. 
The wait ( ) method is called to prevent the producer from producing an item 
before the consumer has consumed the previous item. It is also called to 
prevent the consumer from consuming an item that has not yet been pro- 
duced. Those methods work in conjunction with a writeable flag variable 
that indicates whether or not an item has been produced (from the con- 
sumer's point of view) and whether or not an item has been consumed 
(from the producer's perspective). Also, PC2 uses notify () to wake up the 
other thread when it is waiting. When you run PC2, you should see the 
following output: 

0 produced by producer. 
/'^^ 0 consumed by consumer. 

1 produced by producer. 

1 consumed by consumer. 

2 produced by producer. 

2 consumed by consumer. 

3 produced by producer. 

3 consumed by consumer. 

4 produced by producer. 

4 consumed by consumer. 

5 produced by producer. 

5 consumed by consumer. 

6 produced by producer. 

6 consumed by consumer. 

7 produced by producer. 

7 consumed by consumer. 

8 produced by producer. 

8 consumed by consumer. 

9 produced by producer. 
9 consumed by consumer. 

It is possible for multiple threads to be waiting on an object for a certain 
condition. Which thread gets notified when notify ( ) is called? The choice of 
thread is up to the JLS implementation. 



OUTPUT 
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In addition to wait() and notify (), every object has access to a notifyAll() 
method and two additional wait ( ) methods that take time-out arguments. 
When called, the notifyAll( ) method wakes up all waiting threads. 
Although all waiting threads are woken up, they must still reacquire the 
object lock. Only one of those threads will obtain that lock, after the thread 
that called notif yAll( ) releases the lock. The two additional wait ( ) methods 
permit a thread to wake up if it is not notified within a specific period of 
time. As with the no-argument wait ( ) method and notify ( ) , notif yAll ( ) and 
those other two wait ( ) methods must be called from a synchronized block. 

Thread Interruption 

The joinO, wait(), and sleep () methods throw interruptedException objects 
when they are interrupted. What causes that interruption? Thread declares 
an interrupt ( ) method that, when called, sends an interrupt to the speci- 
fied thread. If the thread is blocked (that is, not running) because of a call 
to sleep ( ) , i oin ( ) , or wait ( ) , the thread is made runnable and continues. 
Otherwise, an internal Boolean flag is set, which can later be returned by 
calls to Thread's interrupted ( ) or islnterrupted ( ) methods. The only differ- 
ence between those methods is that interrupted ( ) is a class method equiva- 
lent to Thread . currentThread (). islnterrupted ( ). 

To see interrupt ( ), islnterrupted () , and interrupted ( ) in action, check out 
the interruptDemo source code in Listing 10.13. 

Listing 10.13: InterruptDemo. java. 
// InterruptDemo. java 

class InterruptDemo 
{ 

void doWork () 
{ 

System. out. println ("Hi"); 

MyThread mt = new MyThread (Thread. currentThread ()); 
mt. start (); 

try 

System. in. read (); 




EXAMPLE 



catch (java.io.IOException e) 



12 71710_CH10 11/21/01 12:28 PM Page 407 




Synchronization 407 



Listing 10.13: continued 

System. out. println (Thread. currentThread ( ) . islnterrupted ()); 
System. out. println (Thread. interrupted ()); 

synchronized (this) 
{ 

try 
{ 

wait 0; 

} 

catch ( InterruptedException e) 
{ 

System. out . println ( "Interrupted" ) ; 

System. out. println (Thread . currentThread (). islnterrupted ()); 
System. out. println (Thread . interrupted ()); 

} 

} 

System. out. println ("Bye"); 

} 

public static void main (String [] args) 
{ 

new InterruptDemo ().doWork (); 

} 



class MyThread extends Thread 
{ 

private Thread t; 

MyThread (Thread t) 
{ 

this.t = t; 

} 

public void run () 
{ 

t. interrupt (); 

try 

{ 

Thread. sleep (5000); 

} 
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Listing 10.13: continued 

catch (InterruptedException e) 

{ 

} 



t. interrupt {); 



} 

} 



The System . in . read ( ) method waits for one or more keys to be pressed on 
the keyboard, with the final key being the Enter (or Return) key. That call 
exists to give the MyThread thread a chance to execute its first t . interrupt 
( ) ; method call before the main thread can make its first calls to 
islnterrupted( ) and interrupted! ). That is done to demonstrate those meth- 
ods returning true, and those true values subsequently print. The main 
thread then waits while the MyThread thread sleeps. Following that sleep, 
the MyThread thread executes t . interrupt ( ) ; for the second time. At that 
point, the main thread's wait ( ) method is interrupted, and its exception 
handler is called. The calls to islnterrupted( ) and interrupt (), within that 
handler, both return false, because the internal flag is not set. Those false 
values subsequently print. 

When might thread interruption be useful? It is possible to use thread 
interruption, instead of a writeable flag, in the earlier producer-consumer 
example. Also, thread interruption can be used to interrupt I/O routines on 
platforms that permit that capability. Finally, thread interruption can be 
useful for synchronizing audio to a video presentation, by way of Java's 
Sound API (which is not discussed in this book). And who knows what you 
might come up with? 

Volatility 

The JLS recognizes the need for threads to have local memory, to aid in 
performance. Local memory can consist of registers and/or cache. Because 
of local memory, it is possible for one thread to change a variable's value in 
main memory, and another thread won't see that change until its local 
memory is refreshed from main memory. For example, during a loop, the 
looping thread might load a Boolean loop control variable's value from main 
memory into a processor register, by way of the JVM, and continue to loop 
while that variable contains true. The loop control thread won't notice if 
some other thread sets that variable's value to false (in main memory). 
That situation can be prevented by using the volatile keyword, which pre- 
fixes a type declaration and forces Java to read a variable's value from 
main memory every time that variable's value is accessed. 
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NOTE 

If a nonvolatile variable's value Is being accessed from a critical section, the JVM 
ensures that the accessing thread obtains that value from main memory and not the 
thread's local memory. 

The following code fragment demonstrates a type declaration that uses 
volatile: 

volatile boolean notFinished = true; 

With early versions of the JVM, a variable's value was always read from 
main memory. As new JVMs are released, new memory models will be 
introduced (along with local memory optimizations). Because one thread 
might change a variable in main memory and another thread only "sees" its 
copy of that variable's value in local memory, it is important to get into the 
habit of declaring such variables with the volatile keyword. 

CAUTION 

Any variable declared with the volatile keyword cannot also be declared with the 
final keyword. 



Scheduling 



Most Java applications consist of multiple threads. (In addition to the main 
thread, there are also internal JVM threads.) On a machine with a single 
processor, only one thread can be running. Therefore, the application's 
threads must share the processor, and it is the responsibility of Java's 
thread-scheduling mechanism — possibly with the aid of the underlying 
operating system's thread scheduler — to determine which thread runs next. 
When a thread pauses so that another thread can run, that pause action is 
either initiated by a call to the sleep () , j oin ( ) , or wait ( ) methods; or by the 
Java thread scheduler when it determines that another thread must run. 
In either scenario, the thread scheduler assigns a new thread to the 
processor. 

CAUTION 

The JLS does not specify the exact mechanism used to schedule threads. Therefore, 
each JVM can use a different mechanism. Some mechanisms are based on what Is 
known as the green-thread model. According to that model, threads are scheduled by 
the JVM. Other mechanisms are based on the native-thread model. According to that 
model, threads are scheduled by the platform's operating system (which hosts the 
JVM). Because of subtleties In how operating systems perform scheduling, and 
because many implementations of the JVM follow the native-thread model. It Is not 
possible to absolutely determine the order of output when multiple threads run. As a 
result, multithreading Is one area where Java's architecture-neutrality breaks down. Care 
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is needed to create multithreaded code tinat runs in a similar fashion on different plat- 
forms; and such code requires extensive testing. The good news is that scheduling is 
rarely an issue in most multithreaded Java programs. One area where scheduling is an 
issue involves a long calculation. You don't want a thread to monopolize the processor 
for the entire calculation. If that happens, and assuming the application has a GUI, the 
user will find the GUI to be unresponsive because the GUI thread cannot run while the 
calculation thread is running. (That assumes a single processor, but is also relevant on 
multiprocessor machines that cannot dedicate enough processors to all threads.) 



Thread States and Priority 

To understand thread scheduling, it is important to reaHze that a thread 
can exist in one of four states: initial, runnable, blocked, or terminating. In 
the initial state, a Thread object has been created, but the object's start ( ) 
method has not yet been called. There is no thread associated with the 
Thread object in that state. In the runnable state, a thread is either running 
and consuming processor cycles or has the potential to run (because it is 
not in one of the other three states.) In the blocked state, a thread is sleep- 
ing, waiting on an object lock, waiting for an I/O operation to complete, and 
so forth. Finally, in the terminating state, a thread has just returned from 
its run( ) method. 

It is the Java thread scheduler's responsibility to select, from its pool of 
runnable threads, a runnable thread as the currently running thread. (On a 
multiprocessor system, the scheduler must select several runnable threads, 
where each of those threads serves as a processor's currently running 
thread. Due to its complexity, only single processor scheduling is exam- 
ined.) That thread is selected on the basis of its priority. A priority is 
assigned to a thread before it is started: When a thread is assigned a prior- 
ity, it keeps that priority throughout its life (although the scheduler can 
silently raise or lower that priority, as appropriate, but those changes are 
not seen by the thread). When scheduling a thread to run, Java's thread 
scheduler pre-empts (interrupts) a currently running thread, if the priority 
of the new thread exceeds the currently running thread's priority, and that 
new thread becomes the currently running thread. Because of pre-emption, 
Java's thread scheduler is known as a pre-emptive, priority-based sched- 
uler. The Java thread scheduler's pre-emptive nature implies that threads 
of lower priority will never run. In other words, those threads starve for 
processor attention. That anomaly is commonly referred to as CPU 
starvation. 

Priorities are represented by integer values. If you examine the Thread class 
in the SDK documentation, you will encounter several priority-related inte- 
ger constants: min priority (the minimum priority that a thread can have), 
MAX PRIORITY (the maximum priority that a thread can have), and NORM_ 
PRIORITY (a thread's normal priority). When a thread is created, its priority 
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defaults to the integer identified by norm priority. A continued examination 
of Thread reveals a pair of priority-related methods: setPriorityO and 
getPriority ( ). The setPriorityO method takes an integer value, which 
must range between min_priority and max priority, and establishes that 
value as the thread's priority — provided that the priority value is not larger 
than the thread group to which the thread's Thread object belongs. (You'll 
learn about thread groups a bit later in this chapter.) 

To see the effects of priority in action, take a look at the SchedDemol source 
code in Listing 10.14. 

Listing 10.14: SchedDemol .Java. 
// SchedDemol . java 

class SchedDemol 
{ 

public static void main (String [] args) 
{ 

MyThread mt1 = new MyThread {); 
mtl.setName ("A"); 

mt1 .setPriority (Thread. NORM_PRIORITY +1); 

MyThread mt2 = new MyThread (); 
mt2.setName ("B"); 

mt1. start (); 
mt2. start (); 



class MyThread extends Thread 
{ 

public void run () 
{ 

while (true) 

System. out. println (getNane ()); 

} 

} 

SchedDemol creates two MyThread objects. The MyThread object referenced by 
mtl is assigned a priority greater than the default priority assigned to the 
object referenced by mt2. That means thread A should always run and 
thread B should never run, because Java's thread scheduler is pre-emptive. 
On some platforms, you will definitely see that behavior: Thread A will 
always run. However, under a Microsoft Windows 32-bit operating system, 
you will notice that thread B occasionally runs. That is due to the behavior 
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of Windows' thread scheduler (which is used in conjunction with the Java 
thread scheduler). The Windows scheduler employs a technique of tem- 
porarily boosting a thread's priority if that thread has not run for a long 
period of time. That technique prevents a low-priority thread from never 
running when a high-priority runnable thread is also present. When the 
thread runs, the Windows scheduler silently reduces the priority to the 
original priority. 

Equal Priority Thread Scheduling 

Multithreaded Java programs typically contain multiple threads of the 
same priority. How does Java's thread scheduler choose between equal pri- 
ority threads? The following discussion answers that question from a con- 
ceptual viewpoint (as opposed to the viewpoint of any specific JVM 
implementation) . 

A JVM can be thought of as using linked list data structures to keep track 
of all threads. To accomplish that task, several linked lists are required: 
One linked list keeps track of blocked threads; another linked list keeps 
track of threads in the initial state; a third linked list keeps track of 
threads in a terminating state; and remaining linked lists keep track of 
runnable threads (on a priority basis): Each of those remaining linked lists 
keeps track of all threads of a specific priority. Furthermore, each linked 
list is ordered. From a priority linked list's perspective, the runnable thread 
at the head of the linked list is the next thread to run, and the thread at 
the tail of the highest priority linked-list is the currently running thread. 
(Note: we are only considering a single-processor scenario.) 

✓ To learn more about linked lists, see "Self-Referential Classes," p. 535. 

The SchedDemQ2 source code in Listing 10.15 demonstrates scheduling of 
equal priority threads, as well as a higher priority thread. 

Listing 10.15: SchedDemo2. java. 
// SchedDemo2. java 

class SchedDe(iio2 
{ 

public static void main (String [] args) 
{ 

MyThread nt1 = new MyThread {); 
mtl.setNane ("A"); 

mt1 .setPriority (Thread. NORM_PRIORITY +1); 



MyThread mt2 = new MyThread (); 
nit2.setName ("B"); 
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Listing 10.15: continued 

MyThread mt3 = new MyThread {); 
mtS.setName ("C"); 

mtl. start {); 
mt2. start (); 
mta. start (); 

} 

} 

class MyThread extends Thread 
{ 

public void run () 
{ 

while (true) 
{ 

System. out. println (getNane ()); 

if (getNane (). equals ("A")) 
try 

Thread. sleep (100); 
catch (InterruptedException e) 



} 

} 

} 

To understand how scheduling works in relation to SchedDemo2's threads, we 
need to examine two kinds of schedulers: non-time-sliced and time-sliced. 
First, we investigate the non-time-sliced scheduler. 

In a non-time-sliced scheduler, a thread x of a given priority continues to be 
the currently running thread until it is either interrupted by a thread y of 
higher priority (when that higher-priority thread starts) or x terminates. If 
X is interrupted by y, x is moved to the end of its linked list, and y runs. 
When either y or x terminates, the thread that is now at the head of x's 
linked list is scheduled to run. 

From SchedDemo2's perspective, assume that A is the first thread to run. A 
continues to run until it calls Thread . sleep ( ) . At that point, either B or C is 
scheduled to run and moved to the end of its norm priority linked list. 
When A is awakened by the processor, it pre-empts B or C (whichever is run- 
ning) and continues to run until it once again calls Thread . sleep ( ) . At that 
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point, the thread at the head of the norm_priority hnked hst is scheduled to 
run and moved to the end of that hnked hst. That thread will be B if c ran 
before being pre-empted by A. Otherwise, the thread will be C. Think of that 
scenario as a toggling scenario: A runs, B runs, A runs, C runs, A runs, B 
runs, A runs, C runs, and so forth (or A runs, C runs, A runs, B runs, A runs, 
C runs, and so on). 

Non-time-sliced schedulers are not fair to threads of equal priority. To com- 
pensate, some schedulers employ the concept of time -slicing. The idea 
behind time-slicing is to run threads of equal priority in such a manner 
that each thread gets the same amount of runtime — a quantum. In a time- 
sliced scheduler, higher priority threads still pre-empt lower priority 
threads. However, when only equal priority threads are running, a thread 
runs until either it is pre-empted by a higher priority thread, it terminates 
or its quantum expires. When the quantum expires, the thread (which is 
located at the end of its priority linked list) is replaced with the thread at 
the head of the linked list and that new thread subsequently moves to the 
end of the linked list. Because threads percolate from the end of the linked 
list to the linked list's head (where they become eligible for scheduling), 
round-robin scheduling is a term commonly used to describe time-sliced 
schedulers. 

From ScheclDemo2's perspective, assume that A is the first thread to run. As 
with the previous example, A continues to run until it calls Thread . sleep ( ) . 
It is not interrupted by either B or c because those threads have lower pri- 
ority. However, when A is put to sleep, B and C alternate in their execution 
until A awakens. That is in sharp contrast to the earlier scenario in which 
only B or C executes until A awakens. 



TIP 

The Thread class provides a yield () method that, when called, yields the current 
thread to another thread of the same priority. The current thread remains runnable but 
Is moved to the end of Its priority linked list. In the absence of time-slicing, yield ( ) Is 
a simpler alternative than changing priorities. However, yield {) Is not as flexible. When 
used In the presence of a time-sliced scheduler, yield () can result in a rare race con- 
dition: The thread scheduler might be In the act of scheduling the thread that Is yield- 
ing. That means the yielding thread does not really yield. However, that race condition Is 
not a problem If a program approaches yield ( ) method calls as hints to the JVM that 
It would like another thread to run. By the way, it Is not really necessary to call yield ( ) 
on a platform that supports time-slicing, as threads will yield when their quantums 
expire. However, If a program must run on both time-sliced and non-time-sliced plat- 
forms, it Is probably a good Idea to use yield(), for simplicity and portability. 
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EXAMPLE 



Thread Groups 



Java places Thread objects in thread groups: Each thread group is an object 
created from the ThreadGroup class (located in the java.lang package). All 
threads, whose Thread objects are placed within a thread group, share cer- 
tain things in common. For example, no thread can exceed the maximum 
priority established by its thread group. ThreadGroup objects are a conve- 
nience: It is possible to manipulate many Thread objects in a similar way 
through a single call to a ThreadGroup method. For example, a call to a 
ThreadGroup object's interrupt () method causes each Thread object's 
interrupt ( ) method to be called. Because of their convenience, thread 
groups are the means by which Java's security mechanism interacts 
with threads. 

You can initialize ThreadGroup objects by calling either of two constructors. 
Each constructor takes a String argument that identifies the name of a 
thread group. Thread objects are added to thread groups by calling appropri- 
ate Thread constructors that take ThreadGroup arguments. 

The ThreadGroupDemol source code in Listing 10.16 demonstrates the cre- 
ation of a thread group and the addition of a Thread object to that group. 

Listing 10.16: ThreadGroupDemol .java. 
// ThreadGroupDemol .java 



class ThreadGroupDemol 
{ 

public static void main (String [] args) 
{ 

ThreadGroup tg = new ThreadGroup ("My ThreadGroup"); 

MyThread mt = new MyThread (tg, "My Thread"); 
mt. start (); 



} 



class MyThread extends Thread 
{ 

MyThread (ThreadGroup tg, String name) 
{ 

super (tg, name); 

} 



public void run () 
{ 

ThreadGroup tg = getThreadGroup (); 
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Listing 10.16: continued 

System. out. println (tg.getName {)); 

} 

} 

ThreadGnoupDemol indicates that a thread can always determine the thread 
group to which its Thread object belongs, by calling Thread's getThreadGroup( ) 
method. When a reference to the thread's ThreadGroup object is obtained, 
ThreadGroup methods can be called (such as getName( ), to obtain the thread 
group's name). 

Thread groups are related to each other in a hierarchy. Except for the root 
thread group, every thread group has a parent thread group. And what is 
the root thread group? The root thread group is the system thread group. 
You will find references to Thread objects associated with system threads 
(such as the garbage collector — also known as the finalizer — thread) in the 
system thread group. ThreadGroup's ThreadGroup(ThreadGroup parent, String 
name) constructor creates a thread group that serves as a child thread group 
of the thread group identified by parent. Furthermore, ThreadGroup's 
getParentO method returns a reference to the parent ThreadGroup object. 

You don't necessarily need to create new thread groups. When you run an 
application, the application establishes a default main thread group. That 
thread group contains a reference to a Thread object associated with the 
main thread and is a child thread group of the system thread group. By 
calling Thread. currentThreadO .getThreadGroup( ) from the main thread, you 
can obtain a reference to the main thread's ThreadGroup object. 

Thread objects are added to thread groups when threads are started and 
removed when their run( ) methods complete. You can enumerate all Thread 
objects contained in the current thread group only, by calling ThreadGroup's 
enumerate (Thread [ ] list) method, or in the current thread group and all 
its subgroups, by calling ThreadGroup's enumerate (Thread [] list, boolean 
recurse) method. Pass a Boolean true value in the recurse parameter to 
include subgroups in an enumeration. For either method, you will need to 
first size the list array by calling ThreadGroup's activeCountO method. 

To learn how to enumerate all threads in all thread groups, check out the 
ThreadGroupDemo2 application source code in Listing 10.17. 

Listing 10.17: ThreadGroupDenio2.]ava. 
// ThreadGroupDemo2. java 




EXAMPLE 



Class ThreadGroupDemo2 
{ 

public static void main (String [] args) 



12 71710_CH10 11/21/01 12:28 PM Page 417 




Thread Groups 417 

Listing 10.17: continued 
{ 

ThreadGroup tg = Thread. currentThread ( ) .getThreadGroup (); 

MyThread mt1 = new MyThread {tg, "first"); 
MyThread nt2 = new MyThread (tg, "second"); 

mt1. start (); 
mt2. start {); 

ThreadGroup parent = tg.getParent (); 

Thread [] list = new Thread [ parent. activeCount ()]; 

int count = parent . enumerate {list, true); 

String [] thdinfo = new String [count]; 

for (int i = 0; i < count; i++) 

thdinfo [i] = list [i].toString (); 



} 



try 
{ 

mt1 .join ( ) ; 
nit2.ioin (); 

} 

catch (InterruptedException e) 

{ 

} 

for (int i = 0; i < count; i++) 

System. out. println (thdinfo [i]); 



class MyThread extends Thread 
{ 

MyThread (ThreadGroup tg, String name) 
{ 

super (tg, name); 

} 



public void run () 
{ 

for (char c = 'A'; c <= 'Z'; C++) 
System. out. print ; 



System. out. print ("\n"); 
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Listing 10.17: continued 
try 
{ 

Thread. sleep (1000); 

} 

catch (InterruptedException e) 

{ 

} 

} 

} 

A careful study of ThreadGroupDemo will raise a few questions. Why is 
toStringO called on each list element and the result assigned to a thdinfo 
element? If we were to print out the contents of list instead of thdinfo, we 
would not be able to see thread group information. The reason is that, after 
the join( ) methods finish, both threads are complete, and their Thread 
objects are automatically removed from the main thread group. By calling 
toString ( ) on each Thread object in the list array and then by saving that 
information to the thdinfo array, we are effectively caching thread group 
information for display at a later time. Second, why are we executing 
mtl .join ( ) ; and mt2. join ( ) ;? The reason: We want both threads to com- 
plete their output before we display a list of Thread objects. That way, we 
won't have the contents of that list interspersed with output from the other 
two threads. Finally, why is sleep ( ) called at the end of MyThread's run( ) 
method? Without that method call, each thread will finish very quickly, 
before we can even perform an enumeration. As a result, we won't see the 
thread information for threads first and second. (You might need to 
increase the sleep delay from 1000 milliseconds on your platform, if you 
are unable to see first and second thread information.) 



TIP 

This chapter briefly touched on the concept of thread groups. For more detailed infor- 
mation, you are encouraged to visit Sun's Java Tutorial and see what it has to say about 
that concept: Tlie ThreadGroup Class (http : / / j ava . sun . com /docs /books /tutorial/ 
es sen tial/ thread s/threadg roup . html). 



What's Next? 



Java encourages the development of classes that can be reused by different 
programs, through its platform-independent package mechanism. The next 
chapter explores the concept of packages and shows you how to create and 
use them. When you start using packages, you'll find them to be a conve- 
nient tool in organizing your classes. 
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Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 

NOTE 

The answers to the Reviewing It, Checi<ing It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 



Reviewing It 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer. 

Instead of calling sleep ( ) to pause a thread, why not introduce a For 
loop statement that does nothing but waste time? For example: for 
(int delay = 0; delay < 20000; delay++) ;. Is that a good approach to 
use, or are there potential problems? 

Why do Thread's sleep ( ) methods include millisecond and nanosecond 
parameters if most platforms that implement a JVM do not support 
that fine-grained resolution? 

In the TimerDemo source code in Listing 10.7, why does RepeatedTask's 
run ( ) method have a System . exit ( ) method call? 

What is the difference between locks and the waiting and notification 
mechanism? 

Why do you think the JLS allows JVMs to use different thread- 
scheduling mechanisms? 

Why are the System . out .print ( ) and System . out . println ( ) methods 
synchronized? 



Checl^ing It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 





REVIEW 



1. 




2. 



3. 
4. 
5. 
6. 
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Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. Which Thread method must be called from a synchronized context? 

a. sleepO 

b. joinO 

c. waitO 

d. All of the above 

2. Which of the following statements is false? 

a. Thread groups are related in a hierarchy. 

b. A thread always reads a volatile variable's value from main mem- 
ory instead of its local memory. 

c. A thread's priority cannot exceed its thread group's maximum 
priority. 

d. A thread that holds an object's lock must reacquire that lock 
when it enters a nested critical section that is guarded by the 
same lock. 

3. In Listing 10.12's PC2 source code, which Shared variable should have 
been declared with the volatile keyword? 

a. anyMoreData 

b. s 

c. writeable 

d. All of the above 

4. What undesirable effect can occur when the yield ( ) method is called 
in the presence of a time-sliced scheduler? 

a. A race condition 

b. Deadlock 

c. CPU starvation 

d. None of the above 
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5. When any of the wait( ) or notify ( )/notifyAll( ) methods are not called 
from a synchronized area, what kind of exception is thrown? 

a. lllegalThneadStateException 

b. IllegalMonitorStateException 

c. InterruptedException 

d. NullPointerException 

6. Which of the following statements is true? 

a. The setPriority( ) method throws an lllegalThneadStateException 
object when passed an argument that is less than 

Thread. MIN_PRI0RITY or greater than Thread. MAX_PRI0RITY. 

b. Deadlock occurs when a low priority thread never gets access to a 
processor because a high-priority thread keeps executing. 

c. A quantum is the interval from the moment a thread starts 
running until the moment the thread terminates. 

d. A class lock is really an object lock involving a Class object. 

7. What kind of variables can be shared among threads? 

a. Local variables 

b. Instance fields 

c. Parameters 

d. All of the above 

8. Which of the following Thread methods are deprecated? 

a. stopO 

b. suspendO 

c. resumeO 

d. All of the above 

9. Which of the following methods is used internally by the j oin ( ) 
methods? 

a. islnterrupted( ) 

b. isAliveO 

c. isDaemonO 

d. isActiveO 
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10. What is a green thread? 

a. A thread that is scheduled by the operating system hosting the 
JVM 

b. A thread executing under a time-shcing scheduler 

c. A thread that is scheduled by the JVM 

d. A thread executing under a non-time-slicing scheduler 

True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. An application always terminates when the main thread terminates. 
True/False 

2. Timer tasks are either one-shot tasks or tasks that run at regular 
intervals. 

True/False 

3. Class locks are acquired by threads that are about to enter instance 
methods. 

True/False 

4. When a thread is sleeping or waiting and its Thread object's 
interrupt ( ) method is called by another thread, the woken thread 
can determine that it was interrupted by calling its islnterrupted ( ) 
method and noting the true return value. 

True/False 

5. The notifyAll( ) method wakes up all threads waiting on an object's 
lock. 

True/False 

6. Thread's start ( ) method can be called after a thread has started and 
before the thread terminates. 

True/False 

7. The default name of any thread is main. 
True/False 
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8. To create a multithreaded applet, you can implement the Runnable 
interface and link the applet object to the Thread API by passing key- 
word this to an appropriate Thread constructor. 

True/False 

9. To accomplish useful work with a timer, you create an object from a 
TimerTask subclass and pass that object's reference to one of Timer's 
schedule 0 methods. 

True/False 

10. Synchronized access to a critical section does not require multiple 
threads to work with the same lock. 

True/False 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. Write a main ( ) method that prints the name of the main thread, 
changes the name to abc, and prints the new name. 

2. Create a Clock application that consists of Clock and Ticker classes. 
The Clock class declares a [nain( ) method that drives the application 
and the Ticker class subclasses Thread. Within the main() method, a 
Ticker object should be created and initialized to the current time by 
calling the Ticker (long time) constructor. (The current time can be 
obtained by calling System. currentTimeMillis ( ).) The Ticker (long time) 
constructor should save the current time in a private instance field. 
After the Ticker object has been created, its associated thread should 
be started. In response to being started. Ticker's run() method should 
alternately print and increment the current time and sleep for one 
second. Because Clock runs indefinitely, how would you stop that 
program? 

3. Modify the previous exercise's Clock application so that a Ticker con- 
structor declares a name parameter that identifies the name of a 
thread. Have the run( ) method print out that name along with the 
current time. Also, in Clock's main( ) method, create two different 
Ticker objects with names A and B and start each object's associated 
thread. What happens if you call setDaemon(true) on each Ticker object 
before calling that Ticker object's start () method? 



APPLY 
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4. What is wrong with the following WierdSyncing source code, and how 
can that code be fixed? 
// WierdSyncing. java 

class WierdSyncing 
{ 

public static void main (String [] args) 
{ 

MyThread mtl = new MyThread ("A"); 
MyThread mt2 = new MyThread ("B"); 

mt1. start (); 
mt2. start (); 

} 

} 

class MyThread extends Thread 
{ 

static String name; 
static int age; 

MyThread (String name) 
{ 

super (name); 

} 

public void run () 
{ 

while (true) 
{ 

synchronized (this) 
{ 

if (getName (). equals ("A")) 
name = "Joe"; 

else 

name = "Jane"; 

try 
{ 

Thread. sleep ((int) (Math. random () * 100)); 

} 

catch (InterruptedException e) 

{ 

} 



if (getName (). equals ("A")) 
age = 40; 
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else 



ge = 37; 



System. out. println ("name = " + name + ", age = " + age); 



} 



} 



5. Computer science students are introduced to the concept of deadlock 
by way of the dining philosophers problem. Several philosophers sit 
around a table. Each philosopher is either thinking, waiting to eat, or 
eating rice. To eat, a philosopher must pick up two chopsticks, one on 
either side of the philosopher's bowl. Unfortunately, only one chopstick 
appears between each bowl. That means adjacent philosophers cannot 
eat at the same time. Philosophers are rather stubborn: They require 
two chopsticks to eat and will not put down a chopstick until they 
have eaten. If every philosopher picks up the left chopstick, it is 
impossible to pick up the right chopstick, because the right chopstick 
is someone else's left chopstick. That is the classic case of deadlock. 

If you are up for a challenge, consider modeling the preceding sce- 
nario. Choose the five philosophers illustrated in Figure 10.2. Design 
the program so that it leads to deadlock and introduce synchronization 
(along with the waiting and notification mechanism) to compensate. 
Good luck. 




Figure 10.2: Fred, John, Alice, Wanda, and Pete: the dining philosophers. 



13 71710_CH11 11/21/01 12:47 PM Page 426 




:47 PM Page 427 




■4 

11 



Packages 

When you start creating Java applications and other programs, you will 
probably discover that those programs contain classes and interfaces that 
can be reused. Rather than duplicate your effort by re-creating those 
classes and/or interfaces, you can organize them into packages — your own 
class libraries. The next time you need a commonly used class or interface, 
you won't have to "reinvent the wheel." Instead, you'll simply access the 
class or interface from a package. This chapter introduces the concept of 
packages, examines the Package and Import directives that you use when 
creating and accessing packages, and shows you how to create your own 
packages. 
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What Are Packages? 



Imagine a file system that stores all files in one directory. You cannot easily 
infer associations between those files. Furthermore, you must make sure 
that no two files have the same name. After a name is used, it cannot be 
reused — which leads (eventually) to the problem of finding appropriately 
descriptive names. A file system solves that problem by providing multiple 
directories (or folders). Under that scenario, two files with the same name 
can coexist in two different directories. 

A Java program consisting of many top-level (that is, non-nested) classes 
and/or interfaces is prone to similar confusion. Eventually, it will be diffi- 
cult to invent appropriate names. Fortunately, Java supplies a solution to 
that problem — packages. 

A package is a library of top-level classes and interfaces. Each package has 
its own namespace, which prevents name conflicts (in much the same way 
that directories prevent filename conflicts). Only public top-level class and 
interface types can be accessed (by name) outside a package. For example, 
public class Computer {} declares a public Computer type whose name 
(Computer) is accessible beyond its package, and interface Device {} 
declares a non-public Device type whose name (Device) can be accessed only 
from within its package. 

TIP 

To call method A In package X's class Fred from method B In any of package Y's 
classes, it Is not enough that package X's class Fred be public. Method A must also be 
public. For example: public class Fred { public void methodA () { } } 

Packages keep classes and interfaces organized. For example, you would 
have trouble navigating the large number of classes and interfaces that are 
part of Java's standard class library if they weren't organized into pack- 
ages. Table 11.1 presents some of the packages that comprise that library. 

Table 11.1: Java's Standard Class Library Packages 
Package Description 

java. applet Contains classes and interfaces that create an 

applet and allow the applet to communicate with its 
context. Examples of java. applet's classes and 
interfaces include the Applet class and the 
AudioCiip interface. 

java.awt Contains classes and interfaces that paint graphics, 

manipulate images, and construct GUIs. Examples 
of java.awt's classes and interfaces include the 
Button, Color, Font, and Image classes, and the 
LayoutManager and PrintGraphics interfaces. 
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Table 11.1: continued 



Package 



Description 



j ava . awt . event 



i ava . beans 



] ava. 10 



java.lang 



java.net 



j ava . security 



java.util 



Contains classes and interfaces tliat deal with the 
different kinds of events fired by AWT GUI compo- 
nents. Examples of j ava. awt. event's classes and 
interfaces include the ActionEvent, KeyEvent, and 
WindowAdapter, classes; and the ActionListener, 
MouseListener, and TextListener interfaces. 
Contains classes and interfaces that are used to 
create components. Examples of j ava. bean's 
classes and interfaces include the BeanDescriptor 
and Introspector classes; and the 
PropertyChangeListener interface. 
Contains classes and interfaces that support 
input/output through streams, serialization, and a 
platform's file system. Examples of java.io's 
classes and interfaces include the FilelnputStream 
and FileWriter classes; and the Datainput and 
Serializable interfaces. 

Contains classes and interfaces that are fundamen- 
tal to the design of the Java language. Examples of 
java.lang's classes and interfaces include the 
Class, Integer, Math, Object, String, and System 
classes; and the Cloneable and Runnable inter- 
faces. 

Contains classes and interfaces that support net- 
work access. Examples of j ava. net's classes and 
interfaces include the ServerSocket, Socket, and 
URL classes; and the SocketOptions interface. 
Contains classes and interfaces that provide Java's 
security framework. Examples of java. security's 
classes and interfaces include the 
AccessController, Permission, Policy, and 
Signature classes; and the Certificate, 
Privatekey, and PublicKey interfaces. 
Contains classes and interfaces that provide the col- 
lections framework, legacy collections, international- 
ization support, and miscellaneous utilities (such as 
string tokenization, random number generation, and 
timers). Examples of java.util's classes and inter- 
faces include the AbstractCollection, Calendar, 
Date, Hashtable, LinkedList, Locale, Properties, 
Random, Stack, StringTokenizer, Timer, and Vector 
classes; and the Collection, Comparator, Observer, 
RandomAccess, and SortedMap interfaces. 



13 71710_CH11 11/21/01 12:47 PM Page 430 




430 Chapter 11: Packages 



Table 11.1 identifies several packages located in a package named java. 
That name identifies the root of Java's standard class library hierarchy (in 
much the same way as a directory-based file system uses a root directory as 
its starting point). Just as you can place directories within directories, 
packages can be placed within other packages. For example, the j ava pack- 
age contains applet, beans, security, and other packages. Those subpack- 
ages are distinguished by using period characters to separate their names, 
as in java.io. (That is equivalent to using the forward slash and backslash 
characters under Solaris/Linux and Windows to separate a path's directory 
names.) 

CAUTION 

You cannot store a subpackage and a same-named class (or interface) in a pacl<age 
because that act would result in a name conflict. For example, you cannot store both a 
class and a package called component in a package called electronics. If that were 
permitted, what would electronics . component refer to: the class or the subpackage? 
You can prevent that problem by always lowercasing the first letter of package names 
and uppercasing the first letter of class names. You can learn more about package and 
other code conventions by reviewing Sun's online Code Conventions for the Java 
Programming Language document (http: //java. sun.com/docs/codeconv/html/ 
CodeConvTOC . doc . html). 



Package Information 

For those of you who have worked with shared object (Solaris) or dynamic 
link (Windows) libraries, you probably know how to access a library's ver- 
sion number, vendor string, and other details. But how do you accomplish 
that task with packages? Java comes to the rescue with a class (in its 
standard class library) whose methods return that information — Package. 

A Package object contains information about the specification and implemen- 
tation of a package. That information is made available by the class loader 
that loaded at least one of the package's classes/interfaces (by way of a class 
file). Specification refers to some plan to which the classes/interfaces 
conform. It consists of title, vendor, and version strings. In contrast, imple- 
mentation refers to a level of conformance to some specification and also 
consists of title, vendor, and version strings. In either case, a version string 
consists of positive integers separated by periods, similar to the Dewey 
Decimal system, for example: 2.0 or 1.2.5. 

Package's static getPackages( ) method returns an array of Package objects — 
each object corresponds to the package of some loaded class. Alternatively, 
the static getPackage(String name) method takes a name argument (of type 
String) that identifies a package and returns either a Package object, if a 
class has been loaded that belongs to the named package, or null, if no class 
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EXAMPLE 



corresponding to the named package was loaded. After you have the Package 
object, you can call getName( ) to retrieve its name; getSpecificationTitle( ), 
getSpecif icationVenclor( ), and getSpecif icationVersion ( ) to retrieve specifi- 
cation information; getImplementationTitle( ), getImplementationVendor( ) , 
and getlmplertientationVersion( ) to retrieve implementation details, and 
so on. 

To learn more about Package, examine the Packageinf o application, whose 
source code appears in Listing 11.1. 

Listing 11.1: Packagelnfo.java. 
// Packagelnfo. Java 



class Packagelnfo 
{ 

public static void main (String [] args) 
{ 

if (args . length != 1 ) 
{ 

System. out. println ("usage: java Packagelnfo packagename" ) ; 
return; 

} 

if (args [0]. equals ("all")) 
{ 

Package [] p = Package. getPackages (); 
for (int i = 0; i < p. length; i++) 

System. out. println (p [i].getName ()); 
return; 

} 



Package p = Package. getPackage (args [0]); 

if (p == null) 

{ 

System. out. println ("could not find package 
return; 

} 



args [0]); 



System. out. println ("Name = " + p.getName ()); 



System. out. println ("Implementation title = " + 
p.getlmplementationTitle ()) 



System. out. println ("Implementation vendor = " + 
p.getlmplementationVendor ()); 
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Listing 11.1: continued 

System. out. println ("Implementation version = " + 
p.getlmplementationVersion ()); 

} 

} 

Packagelnfo demonstrates the following Package methods: getPackages( ), 
getPackage( ), getName(), getImplementationTitle( ), getImplementationVendor( ), 
and getlmplementationVension ( ) . If you run Packagelnfo, by typing j ava 
Packagelnfo all, a list of names for all packages that correspond to loaded 
classes prints. For each name, you can specify that name on the command 
line — as in Java Packagelnfo java.lang. Implementation details then print. 




EXAMPLE 



The Package Directive 



A source file's classes and interfaces are placed into a package. If that 
source file begins with a Package directive, the classes and interfaces are 
stored in the package identified by that directive. The following syntax 
expresses a Package directive in source code: 
' package ' packageName [ ' . ' packageName ... ] ' ; ' 

A Package directive begins with the package reserved word. That word is 
followed by one or more packageNames, separated by period characters. The 
first packageName identifies the main package and remaining packageNames 
identify subpackages. Each packageName is an identifier that must not be a 
reserved word. That directive is terminated by a semicolon character. 

The following Package directives identify an investment package and an 
investment . mutualFund subpackage: 

package investment; 

package investment. mutualFund; 

If a Java implementation maps package names to directories, investment 
would be mapped to an investment directory, and investment. mutualFund 
would be mapped to an investment /mutualFund directory (Solaris or Linux) 
or investment \mutualFund (Windows). The implication is that, for package 
investment;, class files containing compiled class or interface declarations 
would be located in an investment directory whereas, for package 
investment. mutualFund;, class files would be located in investment/ 
mutualFund (Solaris or Linux) or investment\mutualFund (Windows). 

By convention, a package name is not capitalized. If a name consists of 
multiple words, the first letter of each word (except the first) is capitalized. 
Also, when a source file specifies a Package directive, that directive must 



13 71710_CH11 11/21/01 12:47 PM Page 433 




The Import Directive 433 



appear at the top of the source file — only comments can precede the 
Package directive. Furthermore, only one Package directive can be placed 
in a source file. 



CAUTION 

Attempts to either declare multiple Package directives in the same source file or place 
source code (apart from comments) before a Package directive result in compiler 
errors. 



If a source file does not contain a Package directive, classes or interfaces 
declared in that source file are placed into the unnamed package. The 
unnamed package cannot have any subpackages. 

Unique Package Names 

It is important to ensure that published packages be given unique package 
names. Unique names allow packages to be easily and automatically 
installed. If unique names are not chosen, problems (that are potentially 
not solvable) might arise. 

Sun has established a convention to ensure that package names are unique. 
That convention makes use of a company's Internet domain name. That 
name is reversed and then prefixed to an "in-house" package name. For 
example, a company called Generic might have an Internet domain name 
of generic . com. Reversing that name yields com. generic. If Generic has a 
package called financial, the resulting publishable package name is 
com . generic . financial — a financial package that exists in a generic 
package, which exists in a com package. 

In some situations, the Internet domain name might not be a valid package 
name. For example, hyphens might be included in a domain name. If that 
is the case, convention dictates that those hyphens be replaced with under- 
scores. Furthermore, if the domain name includes a reserved word, an 
underscore is appended to the reserved word. 



The Import Directive 



When a class or interface name appears in a source file, the Java compiler 
must identify the package that contains that name. The compiler will then 
combine the package information with the class/interface name and place 
the resulting information into a class file, which later helps the JVM's class 
loader locate the class file. 
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One way to identify the package is to prefix a class or interface name with 
its fully qualified package name, for example: j ava . lang . String s = " abc " ; . 
In the example, String is the class name and j ava. lang is the fully qualified 
package name. However, that approach forces the developer to include the 
package name in each place a class or interface name appears — a tedious 
process. To eliminate the tedium, Java supports the Import directive. 

The Import directive imports type names into a source file during the com- 
pilation process. Because package information is specified by that directive, 
the compiler can associate a type name (appearing by itself in source code 
and belonging to the package specified by Import) with the package. As a 
result, type names can be specified without their package information. The 
following syntax expresses an Import directive in source code: 

import packageName [ ' . ' packageName ... ] ' . ' 
( classInterfaceName \ ' * ' ) ' ; ' 

That syntax describes two kinds of Import directives: single-type and type- 
on-demand. 

A single-tj^e Import directive imports a single public type — a top-level 
class or interface name — from a specific package. That type becomes avail- 
able to all classes and interfaces declared in the source file. 

The following single-type Import directive imports type Vector (a class) 
from the util subpackage of the java package: 
import java. util. Vector; 

The result of that Import directive is: vector can be specified instead of 
java. util. Vector in any place where that class is referenced in the source 
file. For example, if a vector object must be created, the source file can 
specify Vector v = new Vector ();, instead of java. util. Vector v = new 
java. util. Vector ();. 

A single-type Import directive that specifies either a class or an interface 
also declared in the source file causes the compiler to report an error. 

The compiler reports an error when it encounters the following code 
fragment: 

import java. util. Vector; 



EXAMPLE class Vector {} 



The compiler sees an attempt to introduce two types with the same name. 
First, a vector type is imported into a source file. Second, that source file 
also declares another type named Vector. If that was allowed, to which type 
would the compiler refer when encountering Vector v = new Vector ( ) ;? 



In contrast to a single-type Import directive, a type-on-demand Import 
directive (which is identified by the presence of an asterisk character) 
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EXAMPLE 



imports all public types (on an as-needed basis) from a specific package. 
Those types are then available to all classes and interfaces declared in a 
source file. 

The following type-on-demand Import directive imports all types (on an as- 
needed basis) from the awt subpackage of the java package: 
import java. awt.*; 

The result of that Import directive is that if a class like Color (located in 
java. awt) appears in the source file, it can be specified without a java. awt 
prefix. However, if a class like ActionEvent (located in the java. awt. event 
package) appears in the source file, it must be specified as j ava . awt . event . 
ActionEvent. The reason is that import j ava . awt . * ; imports classes and 
interfaces from java. awt — not subpackages like event. 

Type-on-demand Import directives introduce potential confusion. That con- 
fusion results when source code refers to either a class or an interface with- 
out its fully qualified package name and two or more Import directives 
refer to different packages that contain the class/interface type's name. 

Suppose you have two packages — electronics and financial — and each 
package contains a class named Product. Furthermore, suppose the follow- 
ing type-on-demand Import directives are placed at the top of a source file: 

EXAMPLE import electronics.*; 

import financial.*; 

Finally, suppose the compiler encounters the following expression state- 
ment: Product p = new Product ();. To which Product class is that state- 
ment referring? Is it referring to the Product class in the electronics 
package or the Product class in the financial package? Because the com- 
piler cannot make a determination, it reports an error. In a confusing situa- 
tion like that, the fully qualified package name must be used: 
financial. Product p = new financial. Product (); 

or 

electronics. Product p = new electronics. Product (); 

Although the ambiguity is not a common problem, it is something to keep 
in mind for those times when you are scratching your head and wondering 
why the compiler keeps reporting a package-related error. 

CAUTION 

As with the Package directive, Import directives must be placed before any other source 
code (apart from comments and an optional Package directive). Failure to comply 
causes the compiler to report an error. 
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Some types, like String and Package, are located in a special package called 
java.lang. Because those language types are commonly used, the compiler 
does not require import j ava . lang . * ; to be placed in any source file — 
although you can specify that Import directive (if desired). Instead, the 
compiler automatically imports type names (on an as-needed basis) from 
java.lang during compilation. 



TIP 

Is it better to use single-type or type-on-demand Import directives? That depends. Type- 
on-demand Imports place an extra burden on the JVM to help keep track of all package 
members, and that might slow down the overall running of a JVM. In contrast, single- 
type Imports do not place that burden on a JVM. As a rule-of-thumb, if you only need a 
single class or interface from a package, use a single-type Import directive. Otherwise, 
use a type-on-demand Import directive. It takes practice to get into that habit, and I'm 
still learning! 



The CLASSPATH Environment Variable 

A commonly misunderstood (and important) feature of Java is the CLASSPATH 
environment variable. CLASSPATH specifies a list of directory names and/or 
archive filenames that help the JVM's class loader locate class files. If 
CLASSPATH is not set, the class loader regards the current directory (from 
which it was launched) as the default classpath. Continue reading to learn 
how to set CLASSPATH (in Windows and Solaris/Linux) and how the class 
loader searches for class files. 

Setting classpath 

Under Windows, the set command is used to set CLASSPATH. The format is 
set classpath=pat/77 ■,path2. . . , where pathl, path2 (and so on) are the loca- 
tions of class files and archives that contain class files. For example, set 
classpath=c: \proiects; . sets CLASSPATH to the \proiects directory on the c: 
drive and the current directory, respectively. To remove CLASSPATH, issue the 
following command: set classpath=. 

Under Solaris, either setenv classpath pathl :path2: . . . (in the csh shell 
program) or classpath=path1 :path2: . . . export classpath (in the sh shell 
program) is used to set classpath. classpath is removed by issuing either 
unsetenv classpath (csh) or unset classpath (sh). 



TIP 

When attempting to run a Java application, it is possible for the application launcher to 
report a "no class definition found" error. That error typically results from the presence 
of a CLASSPATH environment variable that does not include the current directory as one 
of its entries. By default, when CLASSPATH does not exist, the JVM searches the current 
directory (which usually contains an application's class files). However, when CLASSPATH 
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exists, the JVM only searches CLASSPATH entries. If none of those entries refer to the 
current directory, the application's class files will not be found. Therefore, it is a good 
idea to include the current directory (by way of a period character) as an entry in 
CLASSPATH (whenever CLASSPATH is set). 



Searching for Class Files 

The JVM's class loader searches for class files by using package information 
embedded in a class file (by the Java compiler) and the classpath environ- 
ment variable. If there is no classpath environment variable, the class 
loader checks the current directory to see whether either a class file (if no 
package information is specified) or a directory that matches the first pack- 
age name — a in a.b — (if package information is specified) exists. If neither 
is found, a "no class definition" error is reported. Otherwise, either the class 
file is loaded or the first package directory is searched for either a class file 
or a directory that matches the next package name — b in a.b. That process 
continues until either a class file is found or not found — in which case a "no 
class definition found" error is reported. 

However, if there is a classpath environment variable, its entries are 
searched in a left-to-right order for either a directory or an archive file that 
contains either the class file or the first package name. That search process 
continues until either the class file is found (and loaded) or the class loader 
must report a "no class definition found" error. 

TIP 

Sometimes, it's difficult to determine which class file is loaded by the class loader. That 
is especially true when CLASSPATH contains several entries to different versions of a 
package. To unambiguously identify the class file being loaded, get a copy of JWhich. 
That tool is part of the JavaWorld article Java Tip 105: Mastering thie classpath with 
JWhich (http : / / www. j avaworld . com/j avatips / j w - j avatipl 05 . html). 



Playing with Pacl^ages 



The best way to become comfortable with packages is to explore a couple of 
examples. Each example is developed in a manner that allows you to create 
the example as you read. From time to time, you will be given instructions 
on what to do. Follow those instructions exactly, and you'll save yourself 
much frustration. Before starting an example, make sure there is no 
CLASSPATH environment variable. 

^ \ I / Our first example creates a simple package consisting of a single class and 
s!r ^ simple application (also consisting of one class) that creates an object 

^ ^5 from the package's sole class. Create a directory on your hard drive called 

EXAMPLE myPackage. Then, copy Listing 11.2's source code into Test . j ava and store 
that file in myPackage. 
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Listing 11.2: Test. Java. 
// Test.java 

package myPackage; 

public class Test 
{ 

public Test {) 
{ 

System. out. println ("Test"); 

} 

} 

If desired, you can compile the source code by making sure that myPackage is 
the current directory and issuing the following command: j avac Test . j ava. 
Assuming success, you will see a file called Test. class located in myPackage. 

You don't have to compile Test . j ava because the Java compiler recursively 
compiles source files and is capable of compiling Test . j ava when it comes 
time to compile an application that uses Test. The source code to the 
UseTest application is presented in Listing 11.3. 

Listing 11.3: UseTest. j ava. 
// UseTest.] ava 

import myPackage. Test; 

class UseTest 
{ 

public static void main (String [] args) 
{ 

Test t = new Test ( ) ; 

} 

} 

Copy Listing 11.3's source code into UseTest . java and place that file in the 
same directory as myPackage. In other words, place UseTest. java in the par- 
ent directory of myPackage — and make that parent directory the current 
directory. Figure 11.1 illustrates doing that in a DOS window on a Windows 
machine. 

After the myPackage directory has been created and the two source files 
copied to appropriate directories, compile those files by issuing the follow- 
ing command: j avac UseTest . j ava. Not only should you see a class file 
named UseTest. class in the same directory as UseTest. java, you should also 
see a class file named Test. class in the myPackage directory. Without 
CLASSPATH, the compiler searches the current directory for myPackage. When 
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it finds that directory, the compiler examines its contents. Upon finding 
Test, java and no Test. class, the compiler compiles Test, java into 
Test, class. 



Vtjlume in drive C has no label 
Volume Serial Number is 1380-0FE3 
Directory of C:\jdkl.4\projects 



<DIR> 
<DIR> 
JAV 

MYPACK-1 <DIR> 
1 fileCs) 
3 dirCs) 



17/05/01 9 
17/05/01 9 
56 16/05/01 16 
17/05/01 9 
156 hyte5 
1,633.22 MB free 



33 UsETEEt.java 
01 myPackagE 



C:\jdkl.4\projects>dir myPackage 

Vtslume in drive C has no label 
Volume Serial Number is 13S0-0FE3 
Directory of C:\jdkl.4\projects\myPackagG 



<DIR> 
<DIR> 
TEST-l JAV 

1 fileCs) 

2 dirCs) 

C: \ idkl. ■'l\prQiect5> 



17/05/01 9 
17/05/01 9 
130 16/05/01 16 
130 bytes 
1,633.22 MB free 



01 . . 

33 Test. java 



Figure 11.1: The relationship between the myPackage directory and its parent 
directory, which contains UseTest . java, is shown on the Windows platform. 

NOTE 

In the absence of a -sourcepath option, the Java compiler searches CLASSPATH for 
both class files and source files. It does that for two reasons. First, the compiler must 
ensure that all source files are compiled. Second, it must ensure that, if a source file 
and a class file exist, and if the date stamp of the source file is newer than the date 
stamp of its associated class file, the source file is recompiled. 



And now for the moment of truth. Will UseTest execute? Type the following 
command: java UseTest. Assuming that the current directory is the parent 
directory of myPackage and there is no CLASSPATH, the word Test should print. 
Congratulations! You've just created and tested your first package. 

Suppose you decide to move myPackage to some other location on the hard 
drive. For example, assume the following scenario (under Windows): The 
myPackage directory is located at c: \myPackage, and UseTest. class is located 
in c: \ jdkl .4\proiects. If you try to run UseTest (assuming no CLASSPATH) 
from projects (as the current directory), the class loader will report an 
error. After all, there is no myPackage directory (corresponding to the 
myPackage package) located in projects — where the class loader expects to 
find that directory. The solution to that problem is to set the CLASSPATH vari- 
able to both the location of the myPackage directory and the current direc- 
tory. That task is accomplished by issuing set classpath=c : \ ; . . Now, when 
you try to run UseTest, everything is fine: The class loader looks for a 
myPackage directory in the root directory on the c: drive (which it finds). 
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Our second example consists of an elementary graphics package. That pack- 
age contains a Shape interface and four classes: Point, Circle, Square, and 
Rectangle. Ultimately, geometrically oriented Java programs will create 
objects from most of those classes and manipulate those objects by calling 
their methods. Create a directory on your hard drive called graphics. 

All geometric shapes (with the possible exception of points) must be able to 
draw themselves. That implies each class (except Point) needs to declare a 
method that draws its shape. To enforce that "draw" contract, each class 
(apart from Point) implements an interface called Shape. That interface 
declares a draw( ) method, and its source code is presented in Listing 11.4. 

Listing 11.4: Shape. java. 
// Shape. java 

package graphics; 

interface Shape 
{ 

void draw { ) ; 

} 

Shape declares an abstract and public method called draw(). Although you 
don't see the abstract or public reserved words, any method declared in an 
interface is abstract and public. Copy Shape, java into graphics. 

Point is the first class to be added to the graphics package. Listing 11.5 
presents the source code for that class. 

Listing 11.5: Point. java. 
// Point. java 

package graphics; 

class Point 
{ 

private double x, y; 

Point (double x, double y) 
{ 

this.x = x; 
this.y = y; 

} 

public double getx () 
{ 

return x; 

} 




EXAMPLE 
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Listing 11.5: continued 
public double getY () 
{ 

return y; 

} 

} 

Point serves as the superclass of Circle. After all, a circle is a point with a 
radius. Copy Point, java into graphics. 



NOTE 

Point has not been declared public. Therefore, Point objects cannot be created out- 
side the graphics package. Even if Point had been declared public, it still would not 
be possible to create Point objects because Point's constructor has not been 
declared public: It has package visibility. (The absence of the public, private, or 
protected reserved words implies that visibility.) Because of package visibility. Point's 
constructor can be called only from methods whose classes are declared in the 
graphics package. 



The second class to be placed into the graphics package is Circle. Listing 
11.6 presents the source code for that class. 

Listing 11.6: Circle, java. 
// Circle. java 

package graphics; 

public class Circle extends Point implements Shape 
{ 

private double radius; 

public Circle (double x, double y, double radius) 
{ 

// Initialize the Point layer of a Circle. 

super (X, y); 

this. radius = radius; 

} 

public double getRadius () 
{ 

return radius; 

} 
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Listing 11.6: continued 
public void draw () 
{ 

System. out. println ("Circle"); 

} 

} 

Unlike Point, objects can be created from Circle because Circle and its con- 
structor are declared public. Copy Circle, java into graphics. 

The third class to be placed into the graphics package is Square. Listing 11.7 
presents the source code for that class. 

Listing 11.7: Square, java. 
// Square. java 

package graphics; 

public class Square implements Shape 
{ 

private double length; 
public Square (double length) 
this. length = length; 

public double getLength () 
return length; 

public void draw () 

System. out. println ("Square"); 

} 

Square serves as Rectangle's superclass. Copy Square, java into graphics. 

The final class to be placed into the graphics package is Rectangle. Listing 
11.8 presents the source code for that class. 

Listing 11.8: Rectangle. java. 
// Rectangle. java 

package graphics; 
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Listing 11.8: continued 

public class Rectangle extends Square implements Shape 
{ 

private double width; 

public Rectangle (double length, double width) 
{ 

// Initialize the Square layer of a Rectangle, 
super (length); 
this. width = width; 

} 



public double getWidth () 
{ 

return width; 

} 

public void draw () 
{ 

System. out . print In ( "Rectangle" ) ; 

} 

protected double area () 
{ 

return width * getLength (); 

} 



} 



Rectangle introduces a protected method called area( ). That method calcu- 
lates the area of a rectangle. Normally, area( ) would be declared public but 
has been declared protected to illustrate the use of protected methods with 
packages. Copy Rectangle. Java into graphics. 

At this point, you could compile Circle . j ava by keeping it in the parent 
directory of the graphics folder (which also results in Point. Java and 
Shape . i ava being compiled) and Rectangle . j ava keeping it in the parent 
directory as well (which also results in Square. Java being compiled). 
However, as you will see, that isn't necessary. All you need to do is compile 
an application that refers to the classes in the package and those classes 
that are directly (or indirectly) referenced will compile. One such applica- 
tion is UseGraphics, whose source code appears in Listing 11.9. 
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Listing 11.9: UseGr-aphics. Java. 
// UseGraphics. Java 

import graphics.*; 

class UseGraphics 
{ 

public static void main (String [] args) 
{ 

Circle c = new Circle (10.5, 20.2, 3.5); 
c.draw (); 

Rectangle r = new Rectangle (3.2, 32.5); 
// System. out. println (r.area ()); 

AreaRectangle ar = new AreaRectangle (3.5, 2.6); 
System. out. println ("Area = " + ar.getArea ()); 

} 

} 

class AreaRectangle extends Rectangle 
{ 

AreaRectangle (double length, double width) 
{ 

// Initialize the AreaRectangle layer of a Rectangle, 
super (length, width); 

} 

double getArea () 
{ 

return area ( ) ; 

} 

} 

UseGraphics. Java declares UseGraphics and AreaRectangle. Notice System, 
out .println ( r . area ( ) ) ; , which is commented out. That hne is commented 
out because it will not compile: area( ) is a protected method. As such, 
area( ) can be accessed only by classes in the same graphics package as the 
Rectangle class, which declares area(), and any subclasses of Rectangle, 
regardless of package. That is the justification for AreaRectangle. 
AreaRectangle's getArea () method can legally call area() because 
AreaRectangle is a subclass of Rectangle. 

Copy UseGraphics. java into the parent directory of graphics. Make sure 
there is no GLASSPATH environment variable and that the parent directory is 
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the current directory. Finally, issue the following command to compile 
UseGraphics . j ava: j avac UseGraphics . j ava. Not only does UseGraphics . j ava 
compile, but the source files in graphics also compile. 

To run UseGraphics, type Java UseGraphics. Assuming success, you should 
see the following output: 

Circle 
Area =9.1 

When the class loader encounters Circle (in UseGraphics' main( ) method), it 
notes UseGraphics' graphics/Circle package and type information. The class 
loader looks for a graphics directory in the current directory, which it finds. 
Then, the class loader looks in the graphics directory for Circle. class, 
which it also finds. The same idea holds with the Rectangle class. 

Archives and Package Information 

When CLASSPATH was described, you learned that it specifies a list of direc- 
tory names and/or archive filenames. Those directories contain class files, 
and so do the archives. But what is an archive? An archive is a file that 
contains other files. Archives are beneficial because it is easier to distribute 
a single archive file than the individual files making up the archive. 
Furthermore, if an archive is compressed, it takes up less space and can be 
transmitted from one location to another in less time than the archive's 
files. Java supports archive files by way of its JAR (Java ARchive) file for- 
mat. 

The JAR format is essentially the ZIP file format. The primary difference is 
that JAR files have a . j ar file extension, instead of . zip. (You can unar- 
chive a JAR file by using WINZIP or some other ZIP tool.) Java's Jar tool 
creates JARs, extracts files from JARs, lists the contents of JARs, and so 
on. Because a JAR file can contain one or more packages, it's important to 
know how to use that tool. In this section, you'll get a taste of Jar, as we 
create a package that's stored in a JAR file. 

Remember myPackage; the package containing Test, class? Instead of imple- 
menting that package as a directory, we're going to implement myPackage as 
a directory contained in a JAR file. That is not as unusual as it might 
sound. After all, the packages that make up Java's standard class library 
are distributed in a JAR file called rt . j ar. Follow the next few steps to cre- 
ate a JAR file for myPackage: 

1. Make sure there is no classpath environment variable. 




2. Make sure the myPackage directory contains Test, j ava (just like the 
earlier example involving myPackage). 
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3. Make myPackage's parent directory the current directory. 

4. Create a file called manifest. Make sure that file contains the following 
lines: 

Implementation-Title: myPackage Title 
Implementation -Vendor: myPackage Vendor 
Implementation-Version: 1.0 

5. Assuming manifest is stored in myPackage's parent directory, issue the 
following command: i ar cfm package, jar manifest myPackage. If all 
goes well, you should see a file called package, jar in myPackage's parent 
directory. 

The jar cfm package, jar manifest myPackage command works as follows. 
First, option c creates a JAR file. Second, option f identifies the file as 
package, jar. Third, option m identifies manifest as the file containing addi- 
tional manifest information. Those cfm options are followed by the name of 
the JAR file, the name of the manifest file, and the name of the package 
directory — in that order. 

The manifest file stores metadata in the JAR file. The word "meta" means 
to transcend. In other words, metadata isn't data to be stored in the JAR 
file (although it is stored in the JAR file). Instead, metadata is data about 
the JAR file (which is conveniently stored in the JAR file). What is that 
metadata? In the JAR file creation instructions, you saw implementation - 
Title, Implementation -Vendor, and Implementation -Version. Sound familiar? If 
not, review the earlier material on the Package class. Another example of 
metadata is security details. 

Now that you have a JAR file, you can run UseTest with that file instead 
of the myPackage directory. All you need to do is point CLASSPATH to the name 
of the JAR file and the current directory. Under Windows, specify set 
classpath=package. jar; . Then (assuming there is a UseTest. class class file 
in the current directory), type Java UseTest. The result should be the word 
Test appearing on a line by itself. 

Let's see if we can extract the implementation title, vendor, and version 
information specified in package, jar's manifest. If you recall. Listing 11.1's 
Packagelnfo application was used for that purpose. Unfortunately, we can- 
not use that application with package, jar. Why? Packagelnfo only displays 
package information for those packages for which at least one class file is 
loaded. (It is a certainty that Test. class — contained in package, jar — is not 
one of those class files.) We must modify Packagelnfo so that we can obtain 
information from an arbitrary JAR file. The result of such modifications is 
Packagelnfo2, whose source code appears in Listing 11.10. 
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Listing 11.10: PackageInfo2. Java. 
// PackageInfo2. Java 

class PackageInfo2 
{ 

public static void main (String [] args) 
{ 

if (args. length < 1 || args. length > 2) 
{ 

System. out. println ("usage: java Packagelnfo packagename" + 
" [classname] " ) ; 

return; 

} 

if (args. length == 2) 
try 
{ 

Class. forName (args [1]); 

} 

catch (ClassNotFoundException e) 
{ 

System. out. println ; 
return; 

} 

Package p = Package. getPackage (args [0]); 

if (p == null) 

{ 

System. out. println ("could not find package " + args [0]); 
return; 

} 

System. out. println ("Name = " + p.getName ()); 

System. out. println ("Implementation title = " + 
p.getlmplementationTitle ()); 

System. out. println ("Implementation vendor = " + 
p.getlmplementationVendor ()); 

System. out. println ("Implementation version = " + 
p.getlmplementationVersion ()); 



Packagelnfo2 is similar to Packagelnfo. However, there are two differences. 
First, Packagelnfo2 doesn't take an all argument to display all packages 
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OUTPUT 



corresponding to loaded class files. Second, you can specify one or two 
command-line arguments with Packagelnfo2 — not just one command-line 
argument, as specified by Packageinf o. The first argument is always the 
name of a package. If that package name corresponds to one of those pack- 
ages for which a class file has been loaded, that is the only required argu- 
ment. For example: java Packageinf o2 java.lang. The second argument is 
the name of one of the package's class files. By calling Class. forNameO, 
Packageinf 02 tries to load that class file before calling getPackage( ). If suc- 
cessful, Packageinf 02 can retrieve and print implementation strings from a 
package's manifest. 

To run Packageinf o2 so that implementation details in package, jar's mani- 
fest file print, first make sure that CLASSPATH is pointing to package . j ar and 
the current directory. Then, issue the following command: 
java PackageInfo2 myPackage myPackage.Test. 

If there are no problems, you should see the following output: 
Name = myPackage 

Implementation title = myPackage Title 
Implementation vendor = myPackage Vendor 
Implementation version = 1.0 



What's Next? 



One of the more confusing aspects of Java is the package concept. 
Hopefully, after reading this chapter, you now have a better understanding 
of that concept, and are in a position to make the most of packages. 

We have reached an end to our exploration of the Java language. It is time 
to explore a portion of the standard class library. To begin that exploration, 
the next chapter introduces you to the Character, String, and other related 
APIs. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 



NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 
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Reviewing It 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. Many Java implementations map package names to directories. Can 
you think of another way to implement packages? 

2. What is the unnamed package? 

3. Why should published packages be given unique package names? 

4. Why does an Import directive only import type names from a specific 
package and not also from that package's subpackages? For example, 
why does import j ava . awt . * ; only import type names from j ava . awt 
and not also from j ava . awt . event? 



Checl^ing It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. Which Package method returns a package's name? 

a. getSpecif icationTitleO 

b. getlmplementationTitle 0 

c. a and b 

d. None of the above 

2. Which of the following package names is not a subpackage of java? 

a. awt 

b. event 

c. lang 




REVIEW 




d. None of the above 
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3. What kind of information is not stored in a manifest file? 

a. A copy of classpath 

b. Implementation and specification strings 

c. Security details 

d. None of the above 

4. What is the search order for the following CLASSPATH: 
c : \ ; . ; package . j ar? 

a. Directories contained in package .]ar, followed by the current 
directory, followed by the root directory on the c : drive 

b. The root directory on the c : drive, followed by the current direc- 
tory, followed by the directories contained in package, jar 

c. Sometimes a and sometimes b 

d. None of the above 

5. A "no class definition found" error arises from what? 

a. The class loader cannot find a class file. 

b. The class loader finds a class file whose date stamp is older than 
the date stamp of a corresponding source file. 

c. a and b. 

d. None of the above 

6. A package's class cannot be found because of what? 

a. The class is not declared public. 

b. The class's constructor is not declared public. 

c. a and b 

d. a only 

7. Which of the following statements is true? 

a. Multiple Package directives can be specified in a source file. 

b. A class declaration can precede an Import directive but not a 
Package directive. 

c. A tj^e-on-demand Import directive and a single-type Import 
directive that refer to the same package can coexist in a source 
file. 

d. None of the above 



13 71710_CH11 11/21/01 12:47 PM Page 451 




Checking It 451 

8. Given the domain name package-express.com, a package called tools 
and the previously mentioned naming rules for unique package 
names, which of the following fully qualified package names is correct? 

a. com. package-express. tools 

b. com. package express .tools 

c. com . express_package_. tools 

d. com. package_express. tools 

9. Which of the following statements is false? 

a. Archive files combine multiple files into a single file. 

b. Archive files can be compressed. 

c. A JAR file is an archive file that uses the ZIP file format. 

d. None of the above 

10. If a method is to be accessed by a subclass in another package, that 
method must be declared what? 

a. protected 

b. public 

c. a only 

d. a or b 

True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. The default CLASSPATH consists of the current directory. 
True/False 

2. The Package directive imports a class or interface name into a source 
file so the compiler can identify that name's package when it encoun- 
ters the name without package information in source code. 

True/False 

3. Public top-level class and interface types can be accessed outside a 
package. 

True/False 
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4. A single-type Import directive that imports a type also declared as a 
top-level type in the same source file results in a compiler error. 

True/False 

5. Multiple Package directives can appear in a source file. 
True/False 

6. If two type-on-demand Import directives import the same type name, 
that name must be specified with its fully qualified package name 
wherever it appears in the source file. 

True/False 

7. Java requires package names to be separated from each other with 
colon characters. 

True/False 

8. A single-type Import directive imports types on an as-needed basis. 
True/False 

9. A Package directive must precede all other code (except for comments) 
in a source file. 

True/False 

10. Package's getPackages( ) method returns an array of Package objects, 
where each object corresponds to the package of some loaded class. 

True/False 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. Modify Packagelnfo so that it also calls Package's "getSpecification" 
methods to return and print specification information. 

2. Create a JAR file that contains the class files that comprise this chap- 
ter's graphics package. Call that JAR file graphics . j ar. After you've 
built the JAR file, copy that file and UseGraphics. class into a directory, 
modify CLASSPATH so that it refers to graphics . j ar and the current 
directory, and run UseGraphics. 
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From Characters to String Tokenizers 
From Fundamental Data Structures to Collections 
Mathematics 
Files and Streams 
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From Characters to String Tokenizers 

A long time ago, computers could only "crunch numbers." It wasn't until 
someone discovered how to relate binary numbers to visual symbols that 
computers could also be used to process text, which has resulted in many 
useful text and word processing programs. Fundamentally, text begins with 
characters, and characters can be strung together into strings that repre- 
sent sentences, paragraphs, and anything "textual." Because Java regards 
strings as immutable (read-only), Java also provides string buffers for those 
situations in which mutable strings are necessary. Sometimes, a string 
must be reduced to its elemental parts (tokens) so that meaning can be 
extracted from the string. Java supports that tokenization task by provid- 
ing string tokenizers. This chapter explores characters, strings, string 
buffers, and string tokenizers, by way of Java's Character, String, 
StringBuffer, and StringTokenizer classes. 
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Characters 



Chapter 2 introduced characters. You learned that a character is a mapping 
from a Unicode number to a symbol, that Java supplies a character tj^e, 
and that Java uses the char keyword to represent that type in source code. 
You might think char is all you need to know as far as characters are con- 
cerned. However, characters are important enough to warrant their own 
class in the standard class library: Character. 

Constructing Characters 

Objects created from Character (located in the java.lang package) store indi- 
vidual characters. Each object stores its character in a single internal char 
field. That field is initialized to the contents of the Character (char value) 
constructor's value argument. That character returns whenever Character's 
charValue( ) method is called. 

The following code fragment shows how to create a Character object, initial- 
ize that object to A (by way of the Character(char value) constructor), and 
return the object's value by calling charValue() : 

Character c = new Character ('A'); 

char ch = c.charValue (); // ch contains A 

Why go to all that trouble when it is simpler to write char ch = 'A';? There 
are two benefits to having a Character class. First, Character objects can be 
stored with other objects in collections (discussed in the next chapter), 
whereas char variables cannot be stored in collections. Second, there are 
many useful operations that can be applied to characters (such as convert- 
ing a lowercase letter to an uppercase letter and determining whether some 
character is a digit), and it is convenient to access those operations via 
methods that are declared in the Character class. 



NOTE 

Many of Character's methods are declared with the static keyword. Therefore, you 
must apply the Character, prefix to each of those method names wherever they 
appear in source code. 



Classifying Characters 

Character declares methods for classifying characters as digits, letters, cur- 
rency symbols, paragraph separators, and so on. Those methods are catego- 
rized as "is" methods, a getTypeO method, and a UnicodeBlock of () method. 




15 71710_CH12 11/21/01 2:17 PM Page 457 




Characters 457 



If you have ever written source code in C or C++, you've probably come 
across isdigitO, islower(), and other "is" functions. Each "is" function 
takes an argument that represents a character and returns a value that 
represents Boolean true if the argument is a digit, is a lowercase letter, and 
so on. Not to be outdone, Java provides "is" methods, by way of the 
Character class, to classify characters. Each "is" method returns Boolean 
true if a character classifies as a control character, a defined character, a 
letter, a digit, and so forth. Otherwise, false returns. 

The following code fragment calls Character's isDigit( ) method to classify a 
character as a digit (or not): 
char c = ' 6 ' ; 
EXAMPLE if (Character. isDigit ) 

System. out. println (c + " is a digit."); 

else 

System. out. println (c + " is not a digit."); 




The code fragment produces the following output: 
6 is a digit. 

J^^P" There is a subtle benefit to calling Character. isDigit in place of the more 

traditional c >= '0' && c <= '9' logic. Java's isDigit ( ) method returns 
OUTPUT Boolean true if its character argument is a Latin digit (0-9), a Tamil digit, 
or some other kind of digit. That is not the case with c >= ' 0 ' && c <= ' 9 ' , 
which recognizes only the Latin digits. 

TIP 

When writing programs that will also be used in countries that don't recognize Latin dig- 
its, letters (A-Z and a-z), and other Latin characters, use Character's "is" methods to 
classify characters instead of the more traditional c >= ' 0 ' && c <= ' 9 ' and c >= 
'A' && c <= 'Z' II c >= 'a' && c <= 'z' (and similar) logic. 

Character's isDigit (), isLetter(), and other "is" methods return a Boolean 
true/false value. However, there are times when it is more convenient to 
have a method return a value that identifies the category in which a char- 
acter classifies. That is accomplished by calling Character's getType( ) 
method. 

getType(char c) examines its char argument c and returns a constant that 
identifies that argument's type (that is, the category to which the character 
belongs). Various type constants are declared in Character and range from 
Character. COMBINING SPACING MARK to Character . UPPERCASE LETTER. 
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The following code fragment calls Character's getType( ) method to classify a 
character by returning the appropriate type: 

char ch = '\u0beb'; // Tamil digit, 
int type = Character. getType (ch); 
if (type == Character. DECIMAL_DIGIT_NUMBER) 
System. out. println ("Decimal digit"); 

The code fragment produces the following output: 
Decimal digit 

^F' Java 2 SDK version 1.4 introduces the initial_quote_pungtuation and 

FINAL_QU0TE_PUNCTUATI0N constants into the Character class. Those constants 
OUTPUT represent new getType ( ) return values. 

Java's characters can also be classified by the Unicode block (a group of 
^ 4 related Unicode characters) in which they are situated. To carry out that 
' - - - ' classification, call the of ( ) Unicode block method. That method is located in 
Character's UnicodeBlock inner class. 

of ( ) examines its character argument and returns a UnicodeBlock reference 
value that identifies the character's Unicode block. Examples of Unicode 
blocks include Arabic, Teluga, Georgian, Lao, and so on. 

The following code fragment calls UnicodeBlock's of ( ) method to classify a 
character by returning the appropriate UnicodeBlock: 
System. out. println (Character. UnicodeBlock. of ('\u20ac')); 

The code fragment produces the following output: 

CURRENCY SYMBOLS 




EXAMPLE 



'^P^ Java 2 SDK version 1.4 introduces the concept of directionality into the 
Character class, by way of several "DIRECTIONALITY" constants (such as 
OUTPUT DIRECTIONALITY_RIGHT_TO_LEFT_ARABIC) and a getDirectionality ( ) 

method. Directionality determines the visual ordering of text and the 
getDirectionality ( ) method returns the directionality of its sole character 
1 ,4 argument. That return value is represented by one of the "directionality" 
' ■ ■ ' ' constants. 

Also, Java 2 SDK version 1.4 introduces an isMirrored( ) method into the 
Character class that determines whether the character identified by its 
argument is mirrored (that is, has its appearance horizontally mirrored 
when displayed in right-to-left text). For example, the open round bracket 
character (as identified by Unicode value \u0028) is a mirrored character. 
In left-to-right text, that character appears as ( . However, in right-to-left 
text, that character appears as ) . To prove to yourself that the open round 
bracket character is mirrored, place the following code fragment into a 
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small application, compile the application's source code, and run that 
application: System. out. println (Character. isMirrored ('('));. The output 
will be true. 

Converting Characters 

In addition to classification methods. Character declares several methods 
that convert characters to other characters: forDigit( ), digit ( ), 
toLowerCase( ), toUpperCase( ), and toTitleCase( ). 

The forDigit (int digit, int radix) and digit(char c, int radix) methods 
work in partnership to convert digit (an integer value that represents a 
digit) to its character equivalent (forDigit( )) and convert c (a character) 
to its equivalent integer value (digit ()). In both methods, the character 
represents a digit in a numbering system determined by radix. For exam- 
ple, if radix is set to 10, the base 10 (or decimal) numbering system is 
used for the conversion. Similarly, if radix is set to 16, the hexadecimal 
numbering system is used. 

During conversion, radix must be greater than or equal to Character. MIN_ 
RADIX and less than or equal to Character. max radix. Furthermore, the inte- 
ger value passed as forDigit ()'s digit argument must be greater than or 
equal to zero and less than the value passed as forDigit ( )'s radix argu- 
ment. Also, the character passed as digit ()'s c argument must contain a 
valid digit that ranges from ' 0 ' to the equivalent maximum digit that's 
associated with digit ()'s radix argument. 

The following code fragment demonstrates forDigit ( ) and digit ( ) : 

// Convert 9 to its '9' character value (in the decimal numbering 
// system) . 

EXAMPLE char c1 = Character. forDigit (9, 10); 
System. out. println (Cl); 

// Convert 12 to its 'c' character value (in the hexadecimal 

// numbering system) . 

char c2 = Character. forDigit (12, 16); 

System. out. println (c2); 

// Convert 'c' to its integer value 12 (in the decimal numbering 
// system) . 

int i = Character. digit (c2, 16); 
System. out. println (i); 




The code fragment produces the following output: 

9 

c 



OUTPUT 



12 
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In a manner like f orDigit ( ) and digit ( ) , the toLowerCase ( ) and 
toUpperCase( ) methods work together to convert uppercase letters to their 
lowercase equivalents and the reverse. toLowerCase( ) takes an uppercase 
letter (whether it is Latin A-Z or some other uppercase letter), converts 
that letter to its lowercase equivalent, and returns the result (as a char). 
Similarly, toUpperCaseO takes a lowercase letter (Latin or not), converts 
that letter to its uppercase equivalent, and returns the uppercase value (as 
a char). Any other character passed to either method returns unchanged. 

The following code fragment demonstrates toLowerCaseO and toUpperCase( ): 
System. out. println (Character. toLowerCase ('H')); 
System. out. println (Character. toUpperCase ('i')); 

The code fragment produces the following output: 

Somewhat related to the toLowerCase () and toUpperCase() methods is 
OUTPUT toTitleCase ( ) . That method converts its character argument to titlecase 
and returns the result (as a char). What is titlecase? Titlecase is a third 
form of case. A titlecase character is not a lowercase character and is not an 
uppercase character: It is something in between. Only a few Unicode char- 
acters fall into that category. To get some idea of what a character with 
three forms of case looks like, take a look at Figure 12.1. The three Unicode 
characters in that figure represent three forms of some letter (in a manner 
similar to thinking about A and a as two forms of the Latin alphabet's first 
letter). The top character represents the uppercase form; the bottom char- 
acter represents the lowercase form; and the middle character represents 
the titlecase form. 

V 

DZ \u01c4 

V 

Dz \u01c5 
.V 

dz \u01c6 

Figure 12.1: Uppercase form, lowercase form, and titlecase forms of a letter. 

The following code fragment demonstrates toTitleCaseO (and the corre- 
sponding isTitleCaseO method): 
System. out. println (Character. isUpperCase ('\u01c4')); 
EXAMPLE System. out. println (Character. isTitleCase ('\u01c5')); 

System. out. println (Character. isLowerCase ('\u01c6')); 




System. out. println ((int) Character. toTitleCase ('\u01c4')); 
System. out. println ((int) Character. toTitleCase ('\u01c6')); 
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The code fragment produces the following output: 



C_ true 

g^/p true 

^11^, \[ true 

'"' 453 
OUTPUT 



■ - .^ Java 2 SDK version 1.4 introduces a static toSt ring (char c) method into 
^ ^ the Character class. That method returns a String object consisting solely of 
c's character. 



Strings 



Chapter 2 also introduced strings. You learned that a string is a sequence of 
characters and that Java represents strings with its String type. In the cur- 
rent chapter, you will discover that String is a special type. The Java lan- 
guage provides a pair of shortcuts that facilitate working with that type. 
Those shortcuts are not made available to any other reference type. 
Unfortunately, String's shortcuts are also a source of confusion, especially 
to newcomers. To clear up that confusion, this topic discusses one of those 
shortcuts and delegates a discussion of the other shortcut to the topic of 
string buffers (to be explored later in this chapter). 

Constructing Strings 

Objects created from string (located in the java.lang package) store 
sequences of characters. Each sequence represents a string, and each object 
stores its character sequence in a char [ ] value field when the String object 
is constructed. With other types, that construction takes place in a con- 
structor. However, when it comes to constructing Strings, you optionally can 
use a shortcut. 

The following code fragment uses a shortcut to create a String: 
String s = "Hello"; 

The code fragment creates String variable s, creates a String object that 
contains the characters composing literal string "Hello", and assigns the 
address of that object to s. Actually, there is more to the code fragment than 
is readily apparent. 

When the compiler compiles the preceding code fragment, it places H, e, l, l, 
and 0 in a special area of the class file. That area is known as the class 
file's constant pool (a collection of string literals and other constant values). 
The compiler also generates bytecode instructions to indirectly assign the 
index of that literal to a String variable. 
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NOTE 

The compiler does not place duplicates of string literals in the constant pool. For exam- 
ple, the compiler places only one "abc" string literal (minus the double quote charac- 
ters) in the constant pool, even if source code contains two or more occurrences of 
that literal. 



When the JVM loads the class file, it creates a String object for each string 
literal found in the constant pool. That String object creation takes place 
behind the scenes, and each string object is initialized to a string literal's 
characters. A modification is also made to the memory copy of the constant 
pool so that each bytecode instruction that loads the index of a string literal 
(in the constant pool) will (in reality) load the String object reference. 

The implication of the preceding scenario is that each string literal that 
you specify in your source code becomes a String object at runtime. For 
example, consider the following code fragment: 
String s = new String ("Hello"); 

Without knowing what is happening, you might be inclined to think that a 
single String object is created. However, that is not the case. In reality, two 
String objects are created. First, a String object containing H, e, 1, 1, and o 
is created when the class file loads. Then, its reference is passed to the 
String (String str) constructor. That constructor creates an internal char 
array with a length equal to the number of characters constituting Hello 
(5). The constructor then extracts Hello from the String object, whose refer- 
ence was passed as an argument, and places those characters into that 
array. Finally, a reference to the new String object assigns to s. 

If you look through the SDK documentation for the String class, you will 
encounter a variety of constructors. However, except for constructors used 
in a character/bj^e conversion context, none of the other constructors are 
really necessary to creating and working with strings. By using the afore- 
mentioned shortcut along with String and StringBuff er methods, you can 
create String objects without needing to use those constructors. 



NOTE 

Many of String's and StringBuff er's methods provide an index argument (sometimes 
known as an offset) for accessing a character in the String's or StringBuff er's inter- 
nal character array field or char array argument. That index is always zero-based. In 
other words, index 0 refers to the first character in the internal array 
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Character Arrays and Strings 

Suppose you have a char array and want to create a String object that con- 
tains that array's characters. Although string provides a constructor to 
accomplish that task, you don't need that constructor because String's 
overloaded copyValueOf ( ) methods do the same thing. 

The copyValueOf (char [ ] buffer) method creates a new String object, copies 
the contents of buffer to that object, and returns a reference to the newly 
created String object. In contrast, the copyValueOf (char [] buffer, int 
offset, int count) method creates a new String object, copies that portion 
of buffer starting at index offset and continuing for count characters to 
that object, and returns a reference to the newly created String object. If 
offset is less than zero, count is less than zero, or offset is greater than the 
length of buffer less count, a StringlndexOutOf BoundsException object is 
thrown. 

On the flip side, you might need to copy the contents of a String into a 
char array. Fortunately, String provides a toCharArray ( ) method that 
conveniently creates a new char array containing the String's characters 
and returns a reference to that array. 

Listing 12.1 presents source code to the StringDemol application. That 
source code demonstrates copyValueOf ( ) and toCharArray ( ). 

Listing 12.1: StringDemol .Java. 
// StringDemol .Java 

class StringDemol 
{ 

public static void main (String [] args) 
{ 

char [] vowels = { 'a', 'e', 'i', 'o', 'u', 'y' }; 
String s1 = String. copyValueOf (vowels); 

String s2 = String. copyValueOf (vowels, 0, vowels. length - 1); 

System. out. println (s1); 

System. out. println (s2); 

char [] vowels2 = s2. toCharArray (); 

System. out. println (vowels2); // Calls: System. out. println(char []) 

} 

} 

StringDemol produces the following output: 

aeiouy 
aeiou 



OUTPUT 
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Comparing Strings 

Programs that sort and search string arrays must compare strings to do 
their jobs. Sometimes those comparisons are case sensitive, and sometimes 
they are case insensitive. On occasion, comparison is based on whether or 
not strings start with certain characters or end with certain characters or 
contain identical regions of characters. String provides a variety of methods 
that deal with those situations: compareToO, compareTolgnoreCase(), 
equalsO, equalslgnoreCase( ), stantsWith( ), endsWith(), and regionMatches(). 

The compareTo (String s) and compareToIgnoreCase(String s ) methods com- 
pare the String argument referenced by s with the current String. The com- 
parison is lexicographic (dictionary order). The first character in the 
current String is compared (by Unicode value) with the first character in 
the String referenced by s. If the character in the current String is greater, 
a positive integer value returns. However, if the character in the current 
String is smaller, a negative integer value returns. But if both characters 
have the same Unicode value, comparison continues until either a mis- 
match is found or both Strings are found to contain the same characters. If 
both Strings have the same characters, zero returns. The difference 
between those methods is: compareTolgnoreCase( ) treats uppercase letters 
and lowercase letters identically. 

Having an integer value that indicates whether or not one String precedes 
another String or if both Strings are the same (based on content) is useful 
in sorting applications. However, there are times when it is preferable (in 
decision making) to have a Boolean value that says whether or not two 
Strings are identical. That is the rationale for equals ( ) and 
equalslgnoreCase( ). The equals (Obj ect o) method compares the current 
String with the object referenced by o (which must be a String). If those 
objects contain the same characters. Boolean true returns. Otherwise, 
Boolean false returns. The equalslgnoreCaseO method is the same, except 
that uppercase and lowercase letters are considered to be identical. 



NOTE 

The fact that equals ( ) takes an Obj ect argument and not a String argument might 
come as a surprise. However, remember that equals () is declared in the Object class 
(the ultimate superclass) and has no notion of String or any other subtype. String 
simply overloads equals ( ) so that it can make an effective comparison of Strings. To 
make sure that the argument is of type String, equals () employs instanceof to 
check the argument's type. If it is not String, false returns. 



The startsWith (String prefix) method compares the contents of the current 
String (beginning at index 0) with the contents of the String referenced by 
prefix. If the current String begins with those characters. Boolean true 
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returns. Otherwise, Boolean false returns. Similarly, the endsWith (String 
suffix) method compares the contents of the current String (beginning 
suffix, length 0 characters from the end of the current String) with the con- 
tents of the String referenced by suffix. If the current String ends with 
those characters. Boolean true returns. Otherwise, Boolean false returns. 

Finally, a pair of overloaded regionMatches( ) methods compare two Strings 
to see whether certain regions are identical. The regionMatches(int soffset, 
String target, int toffset, int count) method performs a comparison as 
follows: Comparison begins with the character in the current String located 
at soffset being compared with the character in the target String located at 
toffset. The number of characters to be compared is specified by count. If 
the characters are identical. Boolean true returns. Otherwise, Boolean false 
returns. The regionMatches( boolean ignoreCase, int soffset, String target, 
int toffset, int count) method is similar. The only difference is the 
ignoreCase argument. If true, the comparison is case insensitive. Otherwise, 
the comparison is case sensitive. 

Listing 12.2 presents source code to the StringDemo2 application. That 
source code demonstrates compareToO, compareTolgnoreCaseO, equalsO, 
equalsIgnoreCase( ), startsWith ( ) , endsWith(), and regionMatches( ). 

Listing 12.2: StringDemo2.]ava. 
// StringDeiiio2. Java 

class StringDeno2 
{ 

public static void main (String [] args) 
{ 

String s1 = "This is a test."; 
String s2 = "THIS IS A TEST."; 

int comparison = sl.compareTo (s2); 
if (comparison > 0) 

System. out. println ("s1 > s2"); 

else 

if (comparison < 0) 

System. out. println ("s1 < s2"); 

else 

System. out. println ("s1 equals s2"); 

comparison = s1 . compareToIgnoreCase (s2); 
if (comparison > 0) 

System. out. println ("s1 > s2"); 

else 

if (comparison < 0) 
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Listing 12.2: continued 

System. out. println ("s1 < s2"); 

else 

System. out. println ("s1 equals s2"); 

boolean equal = s1. equals {s2); 
if (equal) 

System. out. println ("s1 equals s2"); 

else 

System. out. println ("s1 does not equal s2"); 

equal = s1 . equalsIgnoreCase {s2); 
if (equal) 

System. out. println ("s1 equals s2"); 

else 

System. out. println ("s1 does not equal s2"); 

if (s1 .startsWith ("This")) 

System. out. println ("s1 starts with This"); 

if (!s2.endsWith ("Test.")) 

System. out. println (" startsWith () and endsWith() are " + 
"case-sensitive. ") ; 

System. out. println (s1 . regionMatches (0, s2, 0, 4)); 
System. out. println (s1 . regionMatches (true, 0, s2, 0, 4)); 

} 

} 



OUTPUT 



StringDeino2 produces the following output: 

S1 > S2 

s1 equals s2 

s1 does not equal s2 

s1 equals s2 

s1 starts with This 

startsWithO and endsWith() are case-sensitive. 

false 

true 



Concatenating Strings 

Although you can easily concatenate strings by using -^, String also provides 
a concat ( ) method to accomplish that task. 

The concat (String s) method either returns a reference to the current 
String object, if the length of the String object referenced by s is zero, or 
does the following: First, getChars( ) is called to place the current String's 
characters in an internal array. Then, getChars() is called on the String 
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EXAMPLE 



OUTPUT 



object referenced by s to place its characters in that array after the first 
batch of characters. Finally, a new String object is created from the con- 
tents of that array, and that reference returns. That all happens behind the 
scenes. (You will learn more about getChans( ) later in this chapter.) 

The following code fragment demonstrates concat(): 
String s = "abc" ; 

System. out. println (s.concat ("def")); 

The code fragment produces the following output: 
abcdef 

TIP 

Should you use + or concat ( ) to concatenate strings? You will probably find that code 
is more compact if you use + to do the concatenation. For example, String s = 
"abc"; System. out. println (s + "def" + "ghi" ); (which prints abcdef ghi) is 
more compact than System, out. println (s.concat ( "def ") .concat ("ghi")); 
(which also prints abcdef ghi). Ultimately, you will have to choose your own preference. 




EXAMPLE 



Converting Strings 

String supports the operations of uppercasing lowercase letters, lowercas- 
ing uppercase letters, trimming whitespace characters (that is, characters 
whose Unicode values are less than or equal to \u0020) from both ends of a 
string, and replacing characters. The conversion operations are manifested 
via the overloaded toLowerCaseO, toUpperCase( ), trim(), and replace () meth- 
ods. Those methods have two things in common. First, they all return refer- 
ences to String objects. Second, if an operation is not performed (such as 
toLowerCaseO encountering a String with no uppercase letters), a reference 
to the current String object returns. Otherwise, a reference to a new String 
object containing the result of the conversion returns. 

With the exception of replace (), the conversion methods do not take any 
arguments. replace() is declared replace(char oldc, char newc) and 
replaces each occurrence of oldc with newc. 

Listing 12.3 presents source code to the StringDemoS application. That 
source code demonstrates toLowerCaseO, toUpperCase(), trimO, and 
replaceO. (StringDemoS's source code also includes a call to String's length() 
method, to return the number of characters in a string. You will learn more 
about length ( ) later in this chapter.) 
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Listing 12.3: StringDemoS. Java. 
// StringDeno3. Java 

class StringDeno3 
{ 

public static void main (String [] args) 
{ 

String s = " \t\n\rABCdef \t\n\r"; 
System. out. println (s. length {)); 
s = s . trim ( ) ; 

System. out. println ("[" + s + "] " + s. length ()); 
System. out. println (s .toLowerCase ()); 
System. out. println (s .toUpperCase ()); 
System. out. println ( "mosquito" . replace ('o', 'e')); 

} 

} 

StringDemoS produces the following output: 
14 

[ABCdef] 6 
abcdef 
ABCDEF 
mesquite 

Extracting Characters 

On occasion, you might want to extract one or more characters from a 
string. To accomplish that task, you can call charAt( ), getChars( ), or either 
of two overloaded substring ( ) methods. 

The charAt(int index) method takes a single integer argument — index — and 
returns the character (as a char) located at index. However, if index is less 
than zero or greater than or equal to the number of characters in the 
string, charAtO throws an indexOutOfBoundsException object. 

The getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin) method 
copies characters from the string to the character array specified by dst. 
Characters are copied, beginning with the character located at the srcBegin 
index and continuing to the character located at one less than the srcEnd 
index. Characters are placed in dst beginning at the dstBegin index. 
However, if srcBegin is less than zero, srcEnd is greater than the number of 
characters in the string, or srcBegin is greater than srcEnd, a 
StringlndexOutOfBoundsException object is thrown. 

You can extract a portion of a string to a new String object by calling either 
of two overloaded substring () methods. The substring (int start) method 
returns a new String object that contains all string characters beginning at 
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OUTPUT 



the start index. In contrast, the other substring (int start, int end) 
method returns a new String object containing all string characters 
beginning at the start index and continuing to one less than the end index. 
By the way, if start is less than zero, end is greater than the number of 
characters in the string buffer, or start is greater than end, a 
StringlndexOutOfBoundsException object is thrown. 

Listing 12.4 presents source code to the StringDemo4 application. That 
source code demonstrates charAt(), getChars() and substring (). 

Listing 12.4: StringDemo4.]ava. 
// StringDeno4. Java 

class StringDeno4 
{ 

public static void main (String [] args) 
{ 

String s = "The quick brown fox"; 
System. out. println (s.charAt (2)); 

char [ ] dst = new char [5] ; 
s.getChars (4, 9, dst, 0); 
for (int i = 0; i < dst. length; i++) 
System. out. print (dst [i]); 

System. out. println ("\n" + s. substring (10)); 
System. out. println (s. substring (10, 15)); 

} 

} 

StringDemo4 produces the following output: 

e 

quick 
brown fox 
brown 



Java 2 SDK version 1.4 introduces the subsequence (int start, int end) 
■ " "4 method into the String class (and the StringBuf f er class, which will be dis- 
1 ,4 cussed later in this chapter). That method behaves the same as substring 
(int start, int end), except that it returns a reference to an object whose 
class implements the CharSequence interface (located in the java.lang pack- 
age). According to the SDK documentation, CharSequence "provides uniform, 
read-only access to many different kinds of character sequences" and 
contains four methods: charAtO, length (), subsequence (), and toString( ). 
Please refer to the SDK documentation to learn more about subsequence () 
and CharSequence. 
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Interning Strings 

Earlier, you learned about a variety of methods that String makes available 
for comparing the contents of String objects. However, in an operation that 
searches through hundreds (if not thousands) of strings, the total time 
taken by those method calls is significant and can impact the performance 
of your program. If the equality operators could be used to perform compar- 
isons, that would definitely boost performance. For example, consider the 
following code fragment: 

String s1 = "abc" ; 
String s2 = "abc" 
String s3 = "def" 

System. out. println (s1 == s2); 
System. out. println (s1 == s3); 

If you run the code fragment, you might be surprised to discover that si 
s2 returns Boolean true and si == s3 returns Boolean false. It would seem 
that == can be used to compare strings. However, there is a catch. Consider 
the following code fragment: 

String s1 = "abc" ; 

String s2 = new String ("abc"); 

System. out. println (s1 == s2); 

If you run that code fragment, sl == s2 returns Boolean false — not what 
was expected. Confused? Read on! 

When a method, like equals( ), is called to compare two strings, the compar- 
ison takes place on a character-by-character basis. The first character in 
each string is compared. If they are the same, the second character in each 
string is compared, and so on, until either a mismatch is found or all char- 
acters have been compared and found to be the same. In contrast == and ! = 
do not compare characters; they compare references. In other words, == and 
! = are used to determine whether two references refer to the same object or 
to different objects: They are not designed to compare the contents of two 
objects. 

If you recall, when the compiler encounters "abc" in source code, it places 
that string literal in a class file's constant pool. However, if the compiler 
encounters a second copy of that string literal, it does NOT place that sec- 
ond copy in the constant pool. Instead, it generates bytecode instructions 
that refer to the first string literal. At runtime, when sl and s2 are 
assigned references to String objects (which are created when the class file 
loads), they are really referring to the same String object that contains abc. 
That is why == returns Boolean true: Both references are the same. 
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The preceding scenario helps explain why the second si == s2 returns 
Boolean false, si is assigned a reference to the String object (created when 
the class file loads) that contains abc. However, s2 is assigned a reference to 
the explicitly created String object that also contains abc. Those are two dif- 
ferent objects, and their references are different. 

String objects created from literal strings that appear in the constant pool 
are said to be interned. In other words, those String objects are stored in a 
pool of memory containing unique Strings (that is. Strings with unique 
sequences of characters). That pool of memory is maintained by the String 
class. There are only two ways to intern a String: the first way is to have a 
string literal appear in source code, and the second way is to use String's 
intern ( ) method. 

When called, intern ( ) checks the String pool to see whether a String with 
the same sequence of characters as the String that calls intern () exists. If 
so, a reference to the pool's String is returned. Otherwise, the String calling 
intern 0 is placed in the pool and its reference returns. In either case, 
intern ( ) guarantees that the returned String reference refers to an object 
with a unique set of characters. Consider the following code fragment: 
String si = "abc" ; 

String s2 = new String ("abc") .intern (); 
System. out. println (si == s2); 

si is assigned a reference to the interned String object that contains abc. 
Then, a new String object is created that contains a duplicate of abc. 
However, the intern ( ) method is called to see whether the pool contains a 
String object that also contains abc. It finds that object and returns its ref- 
erence, which assigns to s2. Because si and s2 now refer to the same object, 
si s2 returns Boolean true. 



TIP 

To speed up operations that search Strings, consider interning those Strings. 



Searching Strings 

Searching a string for either a character or a string is a common task. 
String supports that task by supplying several overloaded indexOf ( ) meth- 
ods (which search for the first occurrence of either a character or a string) 
and several overloaded lastlndexOf () methods (which search for the last 
occurrence of either a character or a string). All those methods return an 
integer that contains either the index of the found character or string, or -1 
if the character/string could not be found. 
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The indexOf( ) methods include: indexOf(int c), indexOf (int c, int index), 
indexOf (String s), and indexOf (String s, int index). If an index argument 
is not specified, the search begins at index zero. Otherwise, the search 
begins at index index. In contrast, the lastlndexOf ( ) methods include: 
lastlndexOf (int c), lastlndexOf (int c, int index), lastlndexOf (String s), 
and lastlndexOf (String s, int index) . If an index argument is not speci- 
fied, the search begins at the index of the last character. Otherwise, the 
search begins at index index. 

Listing 12.5 presents source code to the StringDemoS application. That 
source code demonstrates the indexOf and lastlndexOf ( ) methods. 

Listing 12.5: StringDemoS. java. 
// StringDemoS. java 



class StringDemoS 
{ 

public static void main (String [] args) 
{ 

String s = "The quick brown fox jumped over the lazy ox.' 



System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 



s. indexOf ('o')); 
s. indexOf ( 'o' , 13) ) ; 
s. indexOf ("ox")); 
s. indexOf ("ox", 18)); 
s. lastlndexOf ('o')); 
s. lastlndexOf ( 'o' , 40)) 
s. lastlndexOf ("ox")); 
s. lastlndexOf ("ox", 40) 



OUTPUT 



} 

StringDemoS produces the following output: 

12 
17 
17 
41 
41 
27 
41 
17 



String Length 

If you ever need to know the length of a string, call String's length ( ) 
method. That method returns the number of characters in a String object 
as an integer. 
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EXAMPLE 



The following code fragment demonstrates length(): 
System. out. println ( "abc" .length {)); 

The code fragment produces the following output: 
3 



CAUTION 

Do not confuse String's length () method with an array object's length instance field. 
The length { ) method returns the number of characters in a String object, whereas 
length returns the number of elements in an array. Confusing length ( ) with length 
leads to compiler errors. 



OUTPUT 




EXAMPLE 



OUTPUT 



Values to Strings 

Converting a non-string value to a string can be a challenging task. 
Fortunately, String declares several overloaded valueOf () methods that sim- 
plify the conversion. Each valueOf () method takes an argument of a specific 
type and converts that argument to a sequence of characters, which are 
stored in a new String object. A reference to that new String object returns. 

The following code fragment demonstrates a few of the valueOf ( ) methods: 

String s = String. valueOf (true); 
s += String. valueOf ( ' ' ) ; 
s += String. valueOf (65) ; 
s += String. valueOf ( ' ' ) ; 
s += String. valueOf ( -8.3) ; 
System. out. println (s); 

The code fragment produces the following output: 
true 65 -8.3 



String Buffers 



Objects created from string are immutable: Their contents cannot change. 
Each time you call a String method designed to change a String's contents 
and return the modified String (such as the toUpperCase( ) method), a new 
String returns. The original String, on which that method was invoked, 
remains unchanged. 

The fact that a String object is immutable is both a blessing and a curse. 
Immutability is a blessing because only one copy of a String object exists 
(conserving memory). Immutability is also a curse because attempts to 
modify String objects result in new String objects being created, which 
increases a program's memory requirements. And, if the activity takes 
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place in a loop, the creation of those additional String objects can have a 
negative impact on performance. To deal with those problems, Java 
provides StringBuff er. 

Constructing String Buffers 

The StringBuff er class (located in the java.lang package) is used to create 
objects that represent mutable (read/write) strings. As with string, 
StringBuff er stores a string in an internal char [ ] value array field. Unlike 
String, StringBuff er dynamically expands that array (as necessary) to 
accommodate the string as it grows. 

Either of StringBuff er's StringBuffer( ), StringBuff er(int length), or 
StringBuff er(String s) constructors can be called to create a StringBuffer 
object. StringBuff er( ) creates that object with an internal char [ ] value 
field that contains no characters and (initially) is capable of storing sixteen 
characters before being expanded. In contrast, StringBuff er(int length) 
creates a StringBuffer object with an internal char [ ] value field that con- 
tains no characters and can store length characters, prior to being resized. 
However, if length contains a negative value, that constructor throws a 
NegativeArraySizeException object. Finally, StringBuff er(String s) creates a 
StringBuffer object with an internal char [ ] value field that contains all 
characters found in s. The length of that array is the length of s plus 
sixteen. 

The following code fragment uses the StringBuffer constructors to create 
string buffers: 

// Create an empty StringBuffer whose internal array is capable of 
// storing 16 characters before being expanded. 
StringBuffer sb1 = new StringBuffer (); 

// Create an empty StringBuffer whose internal array is capable of 
// storing 30 characters before being expanded. 
StringBuffer sb2 = new StringBuffer (30); 

// Create a StringBuffer whose internal array contains characters 
// A, B and 0; and is capable of storing 19 characters (which 
// includes A, B and C) before // being expanded. 
StringBuffer sb3 = new StringBuffer ("ABC"); 

After a StringBuffer has been created and the string, represented by 
StringBuffer's internal array, has been modified, that string can be con- 
verted to a new String object by calling toStringO. 




EXAMPLE 



15 71710_CH12 11/21/01 2:17 PM Page 475 




String Buffers 475 



The following code fragment converts a StringBuff er's contents to a new 
String object by calling toString ( ) : 
StringBuff er sb = new StringBuff er {"ABC"); 
EXAMPLE String s = sb. toString (); 

Java 2 SDK version 1.4 introduces the contentEquals (StringBuff er sb) 
4 A method into the String class. That method compares the characters in a 
's, _ String object with the characters in the StringBuff er object referenced by 
sb. If the String and StringBuffer objects contain the same characters, 
contentEquals ( ) returns a Boolean true value. Otherwise, it returns a 
Boolean false value. 





EXAMPLE 



Appending Characters 

When working with string buffers, you might find occasion to add charac- 
ters to the end of a string buffer's internal character array. You accomplish 
that task by calling StringBuff er's overloaded append ( ) methods. Each 
method converts its argument value to a String (unless that value is a 
String) and appends that String's characters to the StringBuff er's internal 
character array. A reference to the StringBuffer returns. For example, 
sb. append (true) ; takes its Boolean true argument value and converts that 
argument value to a String that contains characters t, r, u, and e. Those 
characters then append to the character array, stored in the StringBuffer 
object that's referenced by sb. 

Listing 12.6 presents source code to the StringBuff erOemol application. That 
source code demonstrates StringBuff erDemol's various overloaded append() 
methods. 

Listing 12.6: StringBuff erOemol .Java. 
// StringBufferDemol . java 



class StringBufferDemol 
{ 

public static void main (String [] args) 
{ 

StringBuffer sb = new StringBuffer (); 
sb. append (true); 
sb. append ( 'A' ) ; 

char [] carray = { 'a', 'b', 'c' }; 

sb. append (carray); 

sb. append (carray, 0,1); 

sb. append (3.5d); 

sb. append (2.4f); 

sb. append (45); 

sb. append (90000L); 
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Listing 12.6: continued 

sb. append ("That's all!"); 

System. out. println (sb.toString ()); 

} 

} 

StringBuff enDemol produces the following output: 
trueAabca3.52.44590000That's all! 

The append ( ) methods are also used (behind the scenes) to perform string 
concatenation when either + or += appears in an expression where at least 
OUTPUT one operand is of type String. For example, suppose String s = "abc"; 

String t = s + 32; appears in source code. When the compiler encounters s 
+ 32, it generates bytecode instructions that are equivalent to the following 
code: String t = new StringBuffer (). append (s). append (32) . toString ();. 

CAUTION 

Be careful when using either + or += to concatenate strings. Each concatenation results 
in the creation of a StringBuffer object, various append () method calls, and a call to 
toString ( ) , to convert the StringBuff er's contents to a new String object. All that 
activity has an impact on performance when it appears in a loop. However, when used 
outside a loop, there is no problem with using either + or +=. 

Buffer Capacity 

String buffers have the notion of capacity. That capacity is the length of the 
internal char array and represents the sum total of filled and free elements. 
StringBuff er's capacity ( ) method returns that total as an integer. 

To complement capacityO, StringBuf fer's ensureCapacity ( ) method makes 
sure the internal array's length is no smaller than the integer argument 
(representing a minimum capacity) passed to ensureCapacity (). If the inter- 
nal array's length is smaller, a new internal array is created, whose length 
is the larger of ensureCapacity ( )'s minimum capacity argument and twice 
the old capacity (plus 2). 

Why would you use ensureCapacity ( )? How about: performance. When all 
array elements have been filled (the string buffer's capacity is reached), 
StringBuffer must create a new array and copy the old array's values to the 
new array. Furthermore, at some point, the garbage collector will remove 
the old array from memory. That takes time and can impact performance — 
especially if a loop is involved. Calls to ensureCapacity ( ) at various points in 
the loop can reduce that impact. 
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Listing 12.7 presents source code to the StringBuff erDemo2 application. That 
source code demonstrates the capacity () and ensureCapacity ( ) methods. 

Listing 12.7: StringBufferDemo2. Java. 
// StringBufferDemo2. java 

class StringBuff erDemo2 
{ 

public static void main (String [] args) 
{ 

StringBuff er sb = new StringBuff er (); 

System. out. println (sb. capacity ()); 

sb. ensureCapacity (50); 

System. out. println (sb. capacity ()); 

sb. ensureCapacity (15); 

System. out. println (sb. capacity ()); 

} 

} 

StringBuffenDemo2 produces the following output: 

16 
50 
50 



OUTPUT You might expect the final value to be 15. However, that is not the case. The 
reason is that 1 5 is less than 50, suggesting a capacity reduction, which is 
not allowed. Therefore, the capacity remains at 50. 

TIP 

Consider using ensureCapacity ( ) wlien appending cinaracters to a StringBuffer in a 
loop. Depending on tine nature of tliat loop and the initial capacity of the 
StringBuffer, you might improve performance. 



Buffer Length 

In addition to capacity, buffers also have length. That length is the number 
of characters stored in the internal array — not the length of the array 
(which is what capacity is). To obtain the current buffer length, call 
StringBuff er's length () method. That method returns the length as an 
integer. However, to change that length at any time, call setLength() with 
an integer argument that specifies the new length. If that argument is 
negative, an indexOutOfBoundsException object is thrown. 
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\ I / Listing 12.8 presents source code to the StringBuff erDemo3 application. That 
1 vIB^ source code demonstrates the length () and setLength() methods. 

Listing 12.8: StringBufferDemoS. Java. 

// StringBufferDemo3. java 

class StringBuff erDemoS 
{ 

public static void main (String [] args) 
{ 

StringBuff er sb = new StringBuff er ("ABCDEF"); 

System. out. println (sb. length ()); 
System. out. println (sb.toString ()); 

sb.setLength (4); 

System. out. println (sb. length ()); 
System. out. println (sb.toString ()); 

Sb.setLength (6); 

System. out. println (sb. length ()); 
System. out. println (sb.toString ()); 

} 

} 

StringBuff erDemo3 produces the following output: 
6 

ABCDEF 
4 

ABCD 
6 

ABCD 

When the length is reduced from 6 to 4, the internal char array is truncated 
to contain exactly 4 characters. When the length is subsequently increased 
to 6, null characters ( ' \u0000') append to the array. 

Deleting Characters 

To complement the append ( ) methods (and the insert ( ) methods, which 
are discussed later in this chapter), StringBuff er provides delete () and 
deleteCharAt ( ) . Those methods remove one or more characters from a 
StringBuffer object's internal character array and return a reference to that 
object. The string buffer's capacity does not change; only its length changes. 



OUTPUT 
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OUTPUT 



The delete (int start, int end) method takes two integer arguments: start 
and end. All characters beginning at the start index and ending at one less 
than the end index are deleted. However, if start equals end, no deletion 
takes place. Furthermore, if start is less than zero, end is greater than the 
number of characters in the string buffer, or start is greater than end, a 
StringlndexOutOf BoundsException object is thrown. 

If you only need to delete a single character, call deleteCharAt (int index). 
That method takes a single integer argument — index — that represents the 
position of the character to delete. However, if index is less than zero or 
greater than or equal to the number of characters in the string buffer, a 
StringlndexOutOfBoundsException object is thrown. 

Listing 12.9 presents source code to the StringBuff erDemo4 application. That 
source code demonstrates the delete () and deleteCharAt () methods. 

Listing 12.9: StringBufferDemo4. java. 
// StringBufferDemo4. java 

class StringBuff erDemo4 
{ 

public static void main (String [] args) 
{ 

StringBuff er sb = new StringBuff er ("abcde"); 
sb. delete (1, 3); 

System. out. println (sb.toString ()); 

sb. deleteCharAt (2); 

System. out. println (sb.toString ()); 

} 

} 

StringBuff erDemo4 produces the following output: 

ade 
ad 

Extracting Characters 

Sometimes, you will want to extract one or more characters from a string 
buffer. You can call charAt ( ) , getChars () , or either of two overloaded 
substring ( ) methods to accomplish that task. 

The CharAt (int index) method takes a single integer argument — index — and 
returns the character (as a char) located at index. However, if index is less 
than zero or greater than or equal to the number of characters in the string 
buffer, CharAt 0 throws an indexOutOf BoundsException object. 
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The getChars(int srcBegin, int srcEnd, char[] dst, int dstBegin) method 
copies characters from the string buffer to the character array specified by 
dst. Characters are copied, beginning with the character located at the 
srcBegin index and continuing to the character located at one less than the 
srcEnd index. Characters are placed in dst beginning at the dstBegin index. 
However, if srcBegin is less than zero, srcEnd is less than zero, srcEnd is 
greater than the number of characters in the string buffer, or srcBegin is 
greater than srcEnd, a StringlndexOutOfBoundsException object is thrown. 

You can extract a portion of a string buffer to a new String object by calling 
either of two overloaded substring() methods. The substring (int start) 
method returns a String object that contains all string buffer characters, 
beginning at the start index. In contrast, the other substring (int start, 
int end) method returns a String object containing all string buffer charac- 
ters beginning at the start index and continuing to one less than the end 
index. By the way, if start is less than zero, end is greater than the number 
of characters in the string buffer or start is greater than end, a 
StringlndexOutOfBoundsException object is thrown. 

Listing 12.10 presents source code to the StringBufferDemoS application. 
That source code demonstrates the charAt(), getChars(), and substring () 
methods. 

Listing 12.10: StringBufferDemoS. java. 

// StringBufferDemoS. java 

class StringBufferDemoS 
{ 

public static void main (String [] args) 
{ 

StringBuffer sb = new StringBuffer ("abode"); 
System. out. println (sb.charAt (0)); 

char [ ] dst = new char [2] ; 
sb.getChars (1, 3, dst, 0); 
System. out. println (dst [0]); 
System. out. println (dst [1]); 

System. out. println (sb. substring (2)); 
System. out. println (sb. substring (2, 4)); 

} 

} 




EXAMPLE 
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5^ 



OUTPUT 




EXAMPLE 



StringBufferDemoS produces the following output: 

a 
b 
c 

cde 
cd 

Inserting Characters 

Each append ( ) method has an insert ( ) method counterpart. Whereas 
append ( ) appends the character-equivalent of its argument to the internal 
array's characters, each insert ( ) method inserts the character-equivalent of 
its argument into the internal array at a position specified by an index argu- 
ment. Characters are inserted before the character that appears at that posi- 
tion. However, if the index argument is less than zero or greater than the 
number of characters in the string buffer, a StringlndexOutOfBoundsException 
object is thrown. 

Listing 12.11 presents source code to the StringSuff erOemoe application. 
That source code demonstrates StringBuff er's various overloaded insert () 
methods. 

Listing 12.11: StringBufferDemoS. java. 
// StringBufferDemoS. java 

class StringBuff erDemoe 
{ 

public static void main (String [] args) 
{ 

StringBuff er sb = new StringBuff er (); 

sb. insert (0, true); 

sb. insert (0, 'A'); 

char [] carray = { 'a', 'b', 'c' }; 

sb. insert (0, carray); 

sb. insert (0, carray, 0, 1); 

sb. insert (0, 3.5d); 

sb. insert (0, 2.4f); 

sb. insert (0, 45); 

sb. insert (0, 90000L); 

sb. insert (0, "That's all!"); 

System. out. println (sb.toString ()); 

} 
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StringBuff enDemoe produces the following output: 
That 's all!90000452.43.5aabcAtrue 

Always inserting characters before index zero is like appending in reverse. 



OUTPUT Replacing Characters 

StringBuff er's setCharAtO and replace () methods make it possible to 
replace one or more characters in a string buffer. A reference to the 
StringBuff er object returns from replace (). 

The setCharAt(int index, char c ) method replaces the character at index 
index with the character in c. But, if index is less than zero or greater 
than or equal to the number of characters in the string buffer, a 
StringlndexOutOfBoundsException object is thrown. 

The replace (int start, int end, String s ) method replaces the string 
buffer's characters from index start to one less than index end with charac- 
ters taken from the String object referenced by s. However, if start is less 
than zero, end is greater than the number of characters in the string buffer, 
or start is greater than end, a StringlndexOutOfBoundsException object is 
thrown. That method first removes all characters from start to one less 
than end and then inserts all characters from the String referenced by s 
into the now empty region of the string buffer. 

Listing 12.12 presents source code to the StringBuff erDemo? application. 
That source code demonstrates the setCharAt() and replace () methods. 

Listing 12.12: StringBufferDemo/. java. 
// StringBufferDemo?. java 

class StringBufferDemo/ 
{ 

public static void main (String [] args) 
{ 

StringBuffer sb = new StringBuff er ("abode"); 
String s = "xy"; 




EXAMPLE 



sb.setCharAt (4, 'E'); 

sb. replace (0, 3, s); 

System. out. println (sb.toString ()); 

} 

} 
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EXAMPLE 



OUTPUT 



StringBufferDemo7 produces the following output: 
xydE 

Reversing Characters 

Before saying goodbye to StringBuf fer, there is one other method to exam- 
ine: reverse(). When called, reverse () reorders characters so that they are 
stored in reverse order. That method returns a reference to the StringBuff er 
object. 

The following code fragment demonstrates reverse(): 
StringBuff er sb = new StringBuf fer {"ABC"); 
sb. reverse (); 

System. out. println (sb.toString ()); 

The code fragment produces the following output: 

CBA 



String Tokenizers 



The late 1970s saw the advent of microcomputers (such as the TRS-80 
Model III and Apple II). By today's standards, the graphics capabilities of 
those machines were primitive. For that reason, some of that era's more 
popular computer games (such as adventure games) were text-based. Those 
games operated by displajdng text and prompting the user to enter a sen- 
tence of English words. For example, the user might type "Go west." The 
computer game would then take that text string and extract its elemental 
tokens — and then figure out what to do, based on those tokens. To extract 
the tokens, the game would make use of a string tokenizer. Java's standard 
class library provides string tokenizer capabilities via its StringTokenizer 
class. 



Constructing String Tokenizers 

Objects created from StringTokenizer (located in the java.util package) rep- 
resent string tokenizers. Each object is initialized with a string to be tok- 
enized and returns individual tokens, one token at a time. 

To create a StringTokenizer object, call one of StringTokenizer's three con- 
structors: StringTokenizer(String s), StringTokenizer(String s, String 
delim), or StringTokenizer(String s, String delim, boolean returnDelim). 
Each constructor takes a String reference argument (s) that identifies the 
string to be tokenized. The latter two constructors also take a String refer- 
ence argument (delim) that identifies those characters that serve as delim- 
iters (such as spaces or tabs). Finally, the last constructor takes a Boolean 



15 71710_CH12 11/21/01 2:17 PM Page 484 




484 Chapter 12: From Characters to String Tokenizers 




EXAMPLE 



argument (returnDelim) that determines whether or not dehmiters are 
treated as tokens and returned. (A false value indicates that tokens are not 
returned.) In the absence of delim, " \t\n\n\f " is the default delimiter 
String. And in the absence of neturnDelim, delimiter characters are not 
returned as tokens. 

The following code fragment uses the StringTokenizer constructors to create 
string tokenizers: 

String s = "First sentence. \tSecond sentence."; 

// Create a string tokenizer that tokenizes s, regards spaces, 
// tabs, new-lines, carriage returns and form feeds as 
// delimiters and does not return delimiters as tokens. 
StringTokenizer st1 = new StringTokenizer (s); 

// Create a string tokenizer that tokenizes s, regards tabs as 
// delimiters and does not return delimiters as tokens. 
StringTokenizer st2 = new StringTokenizer (s, "\t"); 

// Create a string tokenizer that tokenizes s, regards tabs as 
// delimiters and returns delimiters as tokens. 
StringTokenizer st3 = new StringTokenizer (s, "\t", true); 

sti is designed to return four tokens: First, sentence., Second, and sentence.. 
Furthermore, st2 is designed to return two tokens: First sentence, and 
Second sentence. Finally, st3 is designed to return three tokens: First 
sentence . , a tab character, and Second sentence . . 

Acquiring Tokens 

After a StringTokenizer object has been created, various methods can be 
called to count the number of tokens, check to see whether more tokens are 
available, and return a token: countTokens( ), hasMoreTokens( ), and two over- 
loaded versions of nextToken( ) are those methods. 

The following code fragment builds on the previous code fragment. It does 
that by showing how to count and return tokens from the StringTokenizer 
object referenced by sti : 

EXAMPLE System. out. println (st1 .countTokens ()); 
while (st1 . hasMoreTokens ()) 

System. out. println (st1 . nextToken ()); 

----^Q^ When applied to the "First sentence . \tSecond sentence. " literal string, the 
'vp preceding code fragment produces the following output: 

- - 4 

OUTPUT First 

sentence. 
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Second 
sentence . 

countTokens( ) examines the String object, which is managed by the 
StringTokenizer object referenced by stl, counts all sequences of characters 
separated by one or more delimiter characters, and returns that value as 
an integer (which subsequently prints). As long as hasMoreTokens ( ) (which 
returns a Boolean value) returns true, nextToken() grabs the current token, 
advances an internal index to point to the next token, and returns the 
saved token (which also subsequently prints). However, should 
hasMoreTokens 0 return false and an attempt be made to return a non- 
existent token, nextTokenO throws a NoSuchElementException object. 

\ I / Suppose you want to retrieve the area code, prefix, and four-digit number 
Sf from a telephone number that's stored in a String object as (999) 999-9999, 
where each 9 represents a digit. Listing 12.13's StringTokenizerDemo source 
EXAMPLE code demonstrates how to use StringTokenizer to accomplish that task. 

Listing 12.13: StringTokenizerDemo. Java. 
// StringTokenizerDemo. java 

import java.util. StringTokenizer; 

class StringTokenizerDemo 
{ 

public static void main (String [] args) 
{ 

String phoneNumber = "(204) 555-1212"; 

StringTokenizer st = new StringTokenizer (phoneNumber, "()"); 
System. out. println ("Number of tokens = " + st.countTokens ()); 
System. out. println ("AC = " + st.nextToken ()); 
System. out. println ("Prefix = " + st.nextToken (") -")); 
System. out. println ("Number = " + st.nextToken ()); 

} 

} 

In StringTokenizerDemo, area code 204, prefix 555, and number 1234 are to 
be returned as separate tokens from phoneNumber. That task is complicated 
by different delimiter characters that are present in the String object: (, ), -, 
and space. Before we look at the program's output (to verify that the appro- 
priate tokens are returned), let's find out how StringTokenizerDemo works. 

To begin, a StringTokenizer object is created with ( and ) as delimiter char- 
acters. Then, countTokensO returns the number of tokens: 2. After all, at 
this point, there are only two tokens: 204 and 555-1212 (which has a lead- 
ing space). Continuing on, the first nextToken ( ) method call skips over the 
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( delimiter, recognizes the ) character as another dehmiter, and returns 204 
(which prints as the area code). The subsequent nextToken ( " ) - " ) method 
call resets the delimiters to ), a space character and a hyphen (-) — and 
returns 555 (which prints as the prefix). In the argument passed to 
nextToken 0, the ) character is required because the very first character that 
will be examined by nextToken () is ): If ) is not included as a delimiter, ) will 
be treated as a token. The space character is required because a space 
appears after ) in phoneNumber: If the space character is not included as a 
delimiter, it will also be treated as a token. Finally, the hyphen is required 
because tokenizing must stop after the third 5 character. The final 
nextToken 0 method call returns 1212 as a token (which prints as the num- 
ber). When that method is called, the current delimiter characters are ), 
space, and hyphen. Actually, only the hyphen is required because the 
hyphen character in phoneNumber is the first character examined when the 
nextToken 0 method call takes place. If that character is not treated as a 
delimiter, -1234 returns (and not 1234). 

Number of tokens = 2 
AC = 204 
Prefix = 555 
Number = 1212 

Notice that countTokensO appears to return the wrong value (2) as far as 
the number of returned tokens is concerned. However, that method is not 
really returning a wrong value. When countTokensO is called, the only rec- 
ognized delimiter characters are ( and ) — and they separate tokens 204 and 
555-1234 (including the leading-space character). 



CAUTION 

Do not rely on the value returned from countTokensO If you plan to change delimiter 
characters during the tokenlzatlon process. In that situation, the Initial value returned 
from countTokens { ) will probably differ from the actual number of returned tokens. 



What's Next? 



Character, String, StringBuf f er, and StringTokenizer: Undoubtedly, you will 
find yourself using one or more of those classes in most of your programs. 
Therefore, it is a good idea to investigate the SDK documentation on them 
and become familiar with their fields and methods. In the next chapter, you 
will learn about data structures and collections — and discover what 
Character and plastic wrap have in common. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 
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NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 




REVIEW 



Reviewing it 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. Why does the String class override toString( )? 

What is the difference between a string buffer's capacity and length? 



2. 
3. 

4. 

5. 

6. 
7. 



Are string literals the only kind of string-based expressions that can 
be interned? 

Character declares a method called getNumericValue( ). That method 
was not discussed in this chapter but is described in the SDK docu- 
mentation. What does getNumericValue( ) accomplish? 

What are the names of the other methods that StringTokenizer uses 
to test for more tokens and return those tokens? Why does 
StringTokenizer declare two sets of methods that do the same thing? 

Why is it not a good idea to concatenate String objects in a loop? 

What are three ways to convert a StringBuffer to a String? 



8. Why is "abc" . length () legal? 



Checi^ing it 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 
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1. What is the initial capacity of a StringBuff er object created with the 
StringBuffer( ) constructor? 

a. 19 

b. 10 

c. 16 

d. None of the above 

2. Which of the following String methods performs a case-sensitive com- 
parison of two String objects and returns its findings as a Boolean 
true or false value? 

a. compareToO 

b. equalsIgnoreCase ( ) 

c. compareToIgnoreCase( ) 

d. equals 0 

3. Which of the following classes is not located in the java.lang package? 

a. StringTokenizer 

b. String 

c. Character 

d. StringBuffer 

4. String's tri[n( ) method removes what characters from the beginning 
and end of a string? 

a. Only spaces and tabs 

b. Only spaces, tabs, carriage returns, and newlines 

c. All characters with Unicode values of 32 or less 

d. All characters with Unicode values of 32 or less and characters 
with Unicode value 127 

5. Which of the following String methods returns the index of the second 
letter B in the "abcbcba" literal string? 

a. indexOf (String s) 

b. indexOf(char c, int index) 

c. lastlndexOf (char c, int index) 

d. All of the above 
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6. System. out. println ("The sky is blue" . substring (4, 9)); prints 
what? 

a. sky is 

b. sky i 

c. sky is blue 

d. None of the above 

7. Which of the following statements is true? 

a. When comparing String objects with ==, the result is true if both 
Strings contain the same values. 

b. A String object is immutable. 

c. String's replaceO method and StringBuf f er's replaceO method 
perform the same task. 

d. All of the above. 

8. Which of String's valueOf ( ) methods calls toString( ) to obtain a String 
value? 

a. valueOf (Object o) 

b. valueOf (char[ ] buffer) 

c. valueOf (char[ ] buffer, int offset, int count) 

d. All of the above 

9. Which of the following StringBuff er methods can be used in a manner 
like reverse ( )? 

a. append 0 

b. insert 0 

c. setCharAtO 

d. replaceO 

10. Which Characters methods are used by the Java compiler to detect and 
tokenize identifiers? 

a. isJavaldentif ierStart ( ) and isJavaldentif ierPart ( ) 

b. isUnicodeldentif ierStart ( ) and isUnicodeldentif ierPart ( ) 

c. isLetterO 

d. All of the above 
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True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. Character's getTypeO method returns a UnicodeBlock reference value 
that identifies a character's Unicode block. 

True/tFalse 

2. f orDigit ( ) converts an integer that represents the numeric value of a 
character in some numbering system to its character equivalent. 

True/tFalse 

3. The first character stored in a String is located at index 1. 
True/tFalse 

4. String and StringBuff er objects store strings in internal character 
arrays. 

True/tFalse 

5. String s = new String ("To be or not to be, that is the 
question. " ) ; results in the creation of one String object. 

True/tFalse 

6. String objects can be modified. 
True/tFalse 

7. A StringBuff er object's internal array expands to accommodate the 
string as it grows. 

True/tFalse 

8. When a StringBuff er's length increases, by calling setLength( ), null 
characters append to the array. 

True/tFalse 

9. A StringTokenizer's default set of delimiters includes backspace. 
True/tFalse 

10. The value returned from countTokens( ) is accurate as long as there are 
no calls to the nextToken( ) method, which changes the current set of 
delimiters. 

True/tFalse 
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Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. Create a Classify application that declares a char variable, assigns a 
character literal to that variable, and calls various Character methods 
to classify the character. Print the result of each Character method call 
along with a suitable message. 

2. Create a Convert application that uses Character's forDigit( ) method 
to convert an integer to its hexadecimal equivalent. Print the resulting 
hex characters. When you have that working, expand Convert to use 
Character's digit ( ) method to convert those hex characters back to the 
original integer — and print that integer. (Hint: Convert is similar to 
Chapter 4's ToBinary application.) 

3. Consider the following code fragment: String s = "Able was I ere I 
saw Elba!"; String prefix = "Able was"; boolean match = 
s.startsWith (prefix) ;. Suppose String did not have a startsWith( ) 
method and you had access only to its charAt ( ) method. How would 
you rewrite the code fragment to accomplish the same task? 

4. Create an STDemo application that uses StringTokenizer to return and 
print all tokens from "The quick brown fox jumps over the lazy dog." 
Use default settings for delimiters and whether or not delimiters 
should be returned. 

5. In 1832, Samuel Morse invented Morse code. That coding scheme was 
used to transmit messages as sequences of dots and dashes over the 
telegraph system. Morse code assigns a specific sequence of dots 
and/or dashes to each letter, digit, and some special characters (such 
as a period, comma, and colon): The absence of either a dot or a dash 
indicates a separation between words. Table 12.1 presents dash-dot 
patterns and the letters -digits they represent. 

Table 12.1: Letters/Digits and Equivalent Morse Code 

Letter/Digit Code 

A 

B ... 

0 

D 

E 

F . . - . 

G 
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Table 12.1: continued 



H 

I 
J 

K 
L 
M 
N 
0 
P 
Q 
R 
S 
T 
U 
V 

w 

X 
Y 



2 
3 
4 
5 
6 
7 
8 
9 
0 



Write an application that reads a command-line argument and encodes 
each letter or digit into its Morse code equivalent. Place one blank after 
each Morse-coded letter/digit. Because only codes exist for uppercase let- 
ters, make sure to convert lowercase letters to uppercase letters prior to 
converting to Morse code. If you are feeling ambitious, extend the program 
to convert from Morse code back to letters/digits. Don't worry about sepa- 
rating words with spaces. 



Letter/Digit 



Code 



z 



NOTE 

The Morse code application is a cliallenging application and requires you to work with 
all four classes presented in this chapter. 



71710_CH12 11/21/01 2:17 PM Page 493 



16 71710_CH13 11/21/01 4:26 PM Page 494 




26 PM Page 495 




4 

. 13 



From Fundamental Data Structures to 

Collections 

Data structures organize data items for easy manipulation. You've already 
seen examples of data structures in previous chapters: arrays, strings — and 
even the Character class. This chapter formalizes the notion of data struc- 
ture and examines a variety of fundamental data structures. Then it 
explores wrappers, which make possible the treatment of primitive type 
values as objects. What's the difference between an array and a linked list? 
The section on self-referential classes provides an answer to that question. 
This chapter concludes by studying the Collections API, a powerful and uni- 
fied framework for manipulating collections of objects. 
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Fundamental Data Structures 



Programs manipulate data items (values), and data items are stored in 
variables. To solve problems, programs structure (organize) those variables 
in various ways. For example, it is common for a program to use an array 
when it needs to organize variables that share a common type. An orga- 
nized grouping of variables is known as a data structure. In the structured 
programming era, a data structure was kept separate from its manipula- 
tion code. In an object-oriented world, a data structure and its manipula- 
tion code are encapsulated into an object: Each Java object contains a data 
structure. 

Java objects typically contain specialized data structures. For example, an 
Employee object contains a specialized data structure that stores a single 
employee's data items in a specific group of variables. Also, a String object 
contains a specialized data structure that stores a single sequence of char- 
acters in an internal array. This chapter is not about specialized data struc- 
tures. Instead, it explores data structures that can be used in generalized 
ways. For example, an array is a generalized data structure: It either stores 
values of a common primitive type, or it stores references to objects of some 
common supertype-subtype mixture. 

Our investigation of Java's data structures begins by focusing on those data 
structures considered to be a fundamental part of that technology. 
Specifically, those data structures consist of arrays and data structure 
classes that have always been a part of Java. 

Arrays 

Of all the various data structures, the array is quite likely the simplest and 
most flexible. An array consists of consecutive memory locations (elements) 
that store data items. Each element, also known as an array component 
variable, is assigned a specific type. All elements share the same type, and 
the number of elements comprising the array is fixed: After an array has 
been created, the number of elements cannot grow or shrink. Each element 
is also assigned an integer value (known as an index) that uniquely identi- 
fies that element. In other words, each element associates with an index. 

Array Creation 

Java specifies three approaches to creating an array. The first approach 
uses an array initializer and was demonstrated in Chapter 3. The second 
(more dynamic) approach uses the keyword new. 
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The following code fragment declares an array variable, allocates memory 
for an array's elements (by using keyword new), and assigns the array's ref- 
erence to the array variable: 
int [ ] X = new int [5] ; 

The code fragment accomplishes the following: 

• int [ ] X declares an array variable (x) and specifies that variable's 
type as int [ ] . That reference type implies that each element must 
contain a data item of type integer. It is important to realize that x is 
an array variable and not an array: That variable will (eventually) 
contain a reference to the first element in an array. 

• new int [ 5 ] allocates memory for five consecutive integer elements, 
zeroes all bits in each element, and returns a reference to the first 
element. 

The equality operator ensures that reference assigns to x. 
CAUTION 

When new is used to create a primitive type array, tlie compiler requires the same primi- 
tive type name keyword (such as int) to appear on both sides of the equality operator. 
As a result, it is illegal to say something like int [] x = new short [5];. Unlike 
primitive type array creation expressions, reference type array creation expressions 
allow a different type name to appear on either side of the equality operator, provided 
that one type is a subtype of the other type. 

Primitive type arrays store primitive type values: Reference t3^e arrays 
store references to objects. When a reference type array is created, by way 
of the second array creation approach, its elements default to null values. 

The following code fragment creates an array of Point elements and 
assigns, to Point variable pl, a reference to the array's first element. The 
code fragment then creates an array of Circle elements and assigns, to 
Point variable p2, a reference to that array's first element. In either case, 
each element's bits are zeroed, which can be interpreted as each element 
containing a null reference: 

Point [] p1 = new Point [5]; 
Point [] p2 = new Circle [5]; 

The third approach to creating an array combines the new keyword with an 
array initializer. Think of the new keyword as counting the number of 
expressions in the array initializer, allocating memory for each expression's 
result, evaluating each expression, and assigning the result to the appropri- 
ate element. Arrays created with that approach are sometimes referred to 
as anonymous arrays. 
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The following code fragment declares an array variable, allocates memory 
for an array's elements (by using keyword new), initializes that memory 
with an array initializer, and assigns the array's reference to the array 
variable: 

double [] y = new double [] { 1.0, 2.0, 3.0, 4.0, 5.0 }; 
The code fragment accomplishes the following: 

• double [ ] y declares an array variable (y) and specifies that variable's 
type as double-precision floating-point [] (as represented by double [ ]). 

• new double [] { 1.0, 2.0, 3.0, 4.0, 5.0 } allocates memory for five 
consecutive double-precision floating-point elements, initializes those 
elements to i .0, 2.0, 3.0, 4.0, and 5.0; and returns a reference to the 
first element. 

• The equality operator ensures that reference assigns to y. 
CAUTION 

When you use the new-initializer approach to creating an array, you must not specify an 
integer between the square brackets on the right side of the equality operator. If you 
specify an integer between those brackets, the compiler reports an error. For example: 
new double [5] { 1.0, 2.0, 3.0, 4.0, 5.0 } causes the compiler to report an 
error when it detects 5 between the square brackets. 

The anonymous array creation approach supports either primitive type 
arrays or reference type arrays. For reference type arrays, each initializer 
expression creates an object and assigns its reference to an array element. 

The following code fragment uses anonymous array creation to create a 
Point array consisting of a single Point element. That element initializes to 
a Point object reference, and a reference to the array assigns to pi. The code 
fragment then uses anonymous array creation to create a Circle array con- 
sisting of a single Circle element. That element initializes to a Circle object 
reference, and a reference to the array assigns to p2: 

Point [] pi = new Point [] {new Point (1.0, 2.0) }; 

Point [] p2 = new Circle [] { new Circle (5.0, 2.0, 3.8) }; 

What do array variables and the arrays they reference look like at an inter- 
nal level? Figure 13.1 illustrates the earlier x and y arrays. 

Figure 13.1 illustrates an important point about Java arrays. All array ele- 
ments are accessed by using integers, beginning with zero. In other words, 
each element's position is relative to zero. The first element is located at 
position zero, and the last element is found at a position that is one less 
than the array's length. 
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Type: double[] 
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-Array elements 
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4.0 


5.0 



- Array elements 



Figure 13.1: The x and y arrays each consist of a sequence of elements 
(array component variables) that is referenced by an array variable. 



\ I / 



EXAMPLE 



Array Access 

After you've created an array, you will want to access individual elements, 
to change or obtain their values. To access an element, specify the following 
syntax: 

identifier ' [ ' expression ' ] ' 

identifier is the name of the array variable, and expression is an integer 
expression that serves as the element's index. That index must be greater 
than or equal to zero and less than the array's length. Any attempt to vio- 
late that rule causes Java to throw an ArraylndexOutOf BoundsException 
object. 

The following code fragment demonstrates legal and illegal array access 
attempts: 

double [] y = new double [] { 1.0, 2.0, 3.0, 4.0, 5.0 }; 
System. out. println (y [0]); // Okay. 

// The following method call results in an ArraylndexOutOf BoundsException 
// object being thrown because negative indexes are illegal. 



System. out. println (y [-1]); 
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System. out. println (y [4]); // Okay. 

// The following method call results in an ArraylndexOutOfBoundsException 
// object being thrown because indexes greater than or equal to an array's 
// length are illegal. 

System. out. println (y [5]); 

Java allows you to assign a subclass array variable's reference to a super- 
class array variable. That makes sense because an array subtype is a kind 
of array supertype. However, if you then try to assign a superclass object 
reference to a subclass array element, by way of the superclass variable, 
Java throws an ArrayStoreException object. 

Java throws an ArrayStoreException object when an attempt is made to exe- 
cute p [0] = new Point ();, in the following code fragment: 

Circle [] c = new Circle [1]; 
Point [ ] p = c; 
p [0] = new Point ( ) ; 

The code fragment assumes that Circle is a subclass of Point. The first line 
creates a Circle array, consisting of a single element. A reference to that 
element assigns to c. The second line copies that reference into p, because a 
Circle array is a kind of Point array. However, the third line results in an 
ArrayStoreException object being thrown. That object is thrown for the fol- 
lowing reasons: 

• The compiler cannot detect that situation (by themselves, all three 
lines are legal Java code). 

• Point (potentially) has fewer members than Circle. If the assignment 
was allowed, we might try executing c [0] .getRadius ( ) — assuming 
that Circle has a getRadius () method. Because Point would not have 
that method and because a Point object was legally assigned to c [0] 
(by way of p [0], which references the same Circle element), an 
attempt to call the nonexistent getRadius () method would crash the 
JVM software. 



CAUTION 

Use caution when accessing array elements. Otherwise, Java might throw an 
ArraylndexOutOfBoundsException object or an ArrayStoreException object. 



Copying an Array 

The System class (located in the java.lang package) declares an arraycopyO 
method for making a copy of an array. The arraycopy (Object src, int 




EXAMPLE 
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srclndex, Object dst, int dstlndex, int length) method copies elements 
from the src array to the dst array. Copying begins at index srclndex, in the 
source array, and continues for length elements. Elements are copied into 
the destination array, beginning at index dstlndex. 

If src and dst refer to the same array, copying is performed as if the src 
array's elements at srclndex through srclndex+length -l were copied into a 
temporary array with length elements, and then the contents of the tempo- 
rary array were copied into the dst array at positions dstlndex through 
dstlndex+length - 1 . 

Use care when passing arguments to that method. If either src or dst con- 
tains null, arraycopyO throws a NullPointerException object. Also, if src or 
dst refers to a non-array object, if src and dst refer to arrays of different 
primitive types, or if either of src or dst refers to a reference type array and 
the other refers to a primitive type array, arraycopyO throws an 
ArrayStoreException object. Finally, if srclndex, dstlndex, or length contains 
a negative value, if srclndex+length > src. length or if dstlndex+length > 
dst. length, arraycopyO throws an IndexOutOf BoundsException object. 

The following code fragment uses arraycopyO to copy the contents of 
hexLetters to hexLetters2: 

char [] hexLetters = { 'A', 'B', 'C, 'D', 'E', 'F' }; 

char [] hexLetters2 = new char [hexLetters. length] ; 

System. arraycopy (hexLetters, 0, hexLetters2, 0, hexLetters. length) ; 



TIP 

System declares arraycopyO as a native method. That means the actual array copying 
code is native processor code. As a result, arraycopy { ) is the fastest means of copy- 
ing one array to another. 



Sorting and Searching Arrays 

Array data structures are commonly used for sorting and searching opera- 
tions. In this section, we'll investigate the use of arrays in a simple sorting 
technique, called the bubble sort. We'll also investigate array usage with 
two major search techniques: linear search and binary search. 

TIP 

Bubble sort is one of the simplest (and slowest) sorting algorithms in existence. More 
complex (and faster) sorting algorithms include the recursive quick sort, insertion sort, 
and merge sort. To learn more about those sorting algorithms, visit your local computer 
bookstore and look for a book that emphasizes algorithms and data structures. 




EXAMPLE 
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The bubble sort makes many passes over an array of data items. During 
each pass, adjacent data items are compared to each other, to determine 
which data item has a smaller numerical value. Depending on whether the 
sort is an ascending sort (smaller data items are ordered before larger data 
items) or a descending sort (larger data items are ordered before smaller 
data items), the data items are swapped (exchanged) so that the smaller or 
larger data item appears first. Bubble sort gets its name from the fact that 
either the smaller or the larger data item "bubbles" to the top of the array 
(element zero) during each pass. 

The BSort source code in Listing 13.1 uses bubble sort to order both an 
array of double-precision floating-point values and an array of references to 
String objects. 

Listing 13.1: BSort.java. 
// BSort.java 

class BSort 
{ 

public static void main (String [] args) 
{ 

double [] X = { 92.3, 45.2, 6.8, -3.6, 10, 9000, -39 }; 

System. out. println ("Before the sort...\n"); 
for (int i = 0; i < x. length; i++) 
System. out. print (x [i] -i- " "); 



for (int pass = 0; pass < x.length-1; pass-i-i-) 
for (int i = 0; i < x.length-pass-1 ; i-i-i-) 
if (X [i] > x [i-H]) 
{ 

double temp = x [i] ; 
X [i] = X [i-H]; 
X [i-H ] = temp; 

} 

System. out. println ("\n\nAfter the sort...\n"); 
for (int i = 0; i < x. length; 
System. out. print (x [i] -i- " "); 



String [] planetNames = 
{ 

"Mercury", "Venus", "Earth", 
"Mars", "Jupiter", "Saturn", 
"Uranus", "Neptune", "Pluto" 

}; 
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Listing 13.1: continued 

System. out. println ("\n\nBefore the sort...\n"); 
for (int i = 0; i < planetNanes. length; i++) 
System. out. print (planetNanes [i] + " "); 

for (int pass = 0; pass < planetNames.length-1 ; pass++) 
for (int i = 0; i < planetNames.length-pass-1 ; i++) 

if (planetNanes [i] .compareTo (planetNames [i+1]) > 0) 
{ 

String temp = planetNames [i]; 
planetNames [i] = planetNames [i+1]; 
planetNames [i+1] = temp; 

} 

System. out. println ("\n\nAfter the sort...\n"); 
for (int i = 0; i < planetNames. length; i++) 
System. out. print (planetNames [i] + " "); 

} 

} 

BSort produces the following output: 
Before the sort . . . 

92.3 45.2 6.8 -3.6 10.0 9000.0 -39.0 
After the sort . . . 

-39.0 -3.6 6.8 10.0 45.2 92.3 9000.0 
Before the sort . . . 

Mercury Venus Earth Mars Jupiter Saturn Uranus Neptune Pluto 
After the sort . . . 

Earth Jupiter Mars Mercury Neptune Pluto Saturn Uranus Venus 



NOTE 

BSort uses String's compareTo(String s) method to compare the contents of the 
current String object with the String object referenced by s. If both String objects 
contain the same contents, that method returns a zero integer value. Otherwise, it 
returns a positive or negative integer value, if the contents of the current String object 
come before or after (in dictionary order) the contents of the String object referenced 
by s, respectively. Chapter 12 discusses compareTo(String s) in detail. 
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The linear search searches through an array for a specific data item, by 
starting with the element at index zero and continuing through successive 
elements until either the data item is found or the end of the array is 
reached. The average number of elements that must be examined is one- 
half of the array's length. For example, an array of 10 million elements 
would require an average of 5 million element examinations. That could 
seriously impact performance. Therefore, linear search is best used with 
small arrays. Linear search can search arrays that are either sorted or 
unsorted. 

The LSearch source code in Listing 13.2 uses linear search to find the loca- 
tion of a double-precision floating-point value and the location of a String 
reference in unsorted arrays. 

Listing 13.2: LSear-ch. java. 
// LSearch. java 

class LSearch 
{ 

public static void main (String [] args) 
{ 

int i; 

double [] X = { 92.3, 45.2, 6.8, -3.6, 10, 9000, -39 }; 

for (i = 0; i < x. length; i-i-i-) 
if (X [i] == 9000) 
break; 

if (i != X. length) 

System. out. println ("9000 found"); 

else 

System. out. println ("9000 not found"); 



String [] countries = 
{ 

"Canada" , 
"South Africa" , 
"China" , 
"India" , 
"Jordan" , 
"Russia" , 
"United States" , 
"France" , 
"Germany" , 
"Holland" , 
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Listing 13.2: continued 

"Iceland" , 
" Sweden" 

}; 

for (i = 0; i < countries . length; i++) 

if (countries [i]. equals ("Iceland")) 
break; 

if (i != countries. length) 

System. out. println ("Iceland found"); 

else 

System. out. println ("Iceland not found" 

String srch = new String ("Iceland"); 
search (srch, countries); 



} 



search (srch. intern (), countries); 



} 



static void search (String srchString, String [] strArray) 
{ 

int i; 

for (i = 0; i < strArray. length; i++) 
if (strArray [i] == srchString) 
break; 

if (i != StrArray. length) 

System. out. println (srchString + " found"); 

else 

System. out. println (srchString + " not found"); 

} 



LSearch searches through an array of double-precision floating-point values 
for 9000 and then performs several searches through an array of references 
to String objects for Iceland. The string search uses two techniques: the 
equals ( ) method and the equality operator (==). The first string search — the 
search that uses equals () — finds Iceland in the countries array The second 
string search, which calls the search ( ) method, does not find Iceland. That 
search fails because it uses == to compare String references, and the refer- 
ence assigned to srch is different than the "Iceland" reference in the 
countries array That problem can be fixed by interning srch, as the final 
call to search 0 accomplishes. By interning srch, LSearch contains only one 
copy of the Iceland object, and the search succeeds. (All Strings referenced 
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from the countries array are automatically interned. That is due to Java 
ensuring that all Strings created behind the scenes, from literals, are 
interned.) LSearch produces the following output: 

9000 found 
Iceland found 
Iceland not found 
Iceland found 

The binary search searches through an array for a specific data item by 
first calculating the index of the middle array element and then by compar- 
ing the searched data item with the middle element's data item. Either the 
search ends, because the data item is found, or the middle element is used 
to determine whether the data item is either in the first half (below the 
middle element) or in the second half (above the middle element) of the 
array. Unlike linear search, binary search can search only arrays that are 
sorted. 

The BSearch source code in Listing 13.3 uses binary search to find the loca- 
tion of a double-precision floating-point value in a sorted array: 

Listing 13.3: BSear-ch . j ava. 
// BSearch.] ava 

class BSearch 
{ 

public static void main (String [] args) 
{ 

double [] X = { -39, -3.6, 6.8, 10, 45.2, 92.3, 9000 }; 
double srchValue = 6.8; 

int lowerlndex = 0, upperlndex = x. length - 1; 

while (lowerlndex <= upperlndex) 
{ 

int niddlelndex = (lowerlndex -i- upperlndex) / 2; 



if (srchValue > x [middlelndex] ) 
lowerlndex = middlelndex -i- 1; 

else 

if (srchValue < x [middlelndex]) 
upperlndex = middlelndex - 1; 

else 

break; 



if (lowerlndex > upperlndex) 
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Listing 13.3: continued 

System. out. println ("6.8 not found"); 



else 



System. out. println ("6.8 found"); 



} 



} 



BSearch produces the following output: 
6.8 found 

The maximum number of elements that need to be examined during a 
binary search is logjU. For example, 1,024 elements would take at most 10 
OUTPUT examinations, and 1,048,576 elements would take at most 20 examinations. 
Contrast that with an average of 512 and 524,288 examinations, respec- 
tively, if linear search was used. 

TIP 

The SDK supplies an Arrays class that declares various utility class methods, such as 
sortO and binarySearch ( ) . 

TWO-DIIVIENSIONAL ARRAYS 

Arrays are said to have dimension — the number of indexes used to access 
an element. Thus far in this book, only single-index (one-dimensional) 
arrays have been presented. However, Java also supports arrays of more 
than one dimension. The most widely created and used multidimensional 
array is quite likely the two-dimensional array — or table, as it is commonly 
known. A table can be viewed as a rectangle, divided into a grid of rows and 
columns. An element exists where a row and column intersect and is identi- 
fied by a (row, column) pair of indexes, as Figure 13.2 illustrates. 



Rows 



Columns 



(0, 0) 


(0, 1) 


(0, 2) 


(1,0) 


(1, 1) 


(1,2) 


(2, 0) 


(2, 1) 


(2, 2) 



Element position: (row, column) 



Figure 13.2: Conceptually, a two-dimensional array (or table) is nothing 
more than a grid of elements, where each element is indexed by a ( row, col- 
umn) pair. 
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A table is declared and created by using either of the following three syntaxes: 

typeldentifier '[' ']' '[' ']' arrayVariableldentifier '=' 

'{' rowlnitializer [ ',' rowlnitializer ... ] '}' ';' 

typeldentifier '[' ']' '[' ']' arrayVariableldentifier '=' 

' new' typeldentifier ' [ ' rowExpression ' ]' ' [' ' ] ' ' ; ' 

typeldentifier '[' ']' '[' ']' arrayVariableldentifier '=' 
' new' typeldentifier ' [ ' ' ] ' ' [ ' ' ] ' 
'{' rowlnitializer [ ',' rowlnitializer ... ] '}' ';' 

where rowlnitializer has the following syntax: 
' { ' columnExpression [ ' , ' columnExpression ... ] ' } ' 

In memory, a table consists of a one-dimensional row array of references to 
one-dimensional column arrays of values. The first and third syntaxes auto- 
matically construct that representation. In contrast, the second syntax con- 
structs only the row array. A separate column must be manually 
constructed for each element in the row array. 

The following code fragment uses the first syntax to declare and create a 
two-row by three-column table: 
char [ ] [ ] yesNo = 
{ 

{ 'Y', 'N', 'Y' }, 
{ 'N', 'Y', 'Y' } 

}; 

In memory, the table consists of a one-dimensional two-element row array, 
and each element of the row array references a three-element column array, 
as shown in Figure 13.3. 

Row index: 0 1 



yesNo 








> 



I Y I N I Y I I N I Y I Y I 
Column index: 0 12 0 12 

Figure 13.3: A two-row by three-column character array, as it appears in 
memory. 





EXAMPLE 
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To access a table element, specify the following syntax: 

arrayVariableldentifier '[' rowExpression ']' '[' columnExpression ']' 

Using that syntax, you would access the value at (row 0, column 1) in the 
yesNo table by specifying yesNo [0] [1 ]. 

\ I / The TableDemo source code in Listing 13.4 contrasts the three syntaxes for 
declaring and creating the same table. 

Listing 13.4: TableDemo. java. 
// TableDemo. java 

class TableDemo 
{ 

public static void main (String [] args) 
{ 

int [][] x1 = { { 1, 2, 3 }, { 4, 5, 6 }}; 
dump (x1); 

int [] [] x2 = new int [2] [] ; 
for (int i = 0; i < x2. length; i++) 
x2 [i] = new int [3] ; 

x2 [0][0] = 1; x2 [0][1] = 2; x2 [0][2] = 3; 
x2 [1][0] =4; x2 [1][1] = 5; x2 [1][2] = 6; 
dump (x2); 



int [][] x3 = new int [][] { { 1 , 2, 3 } , { 4, 5, 6 }}; 
dump (x3); 



} 



static void dump (int [][] array) 
{ 

for (int row = 0; row < array. length; row++) 
{ 

for (int col = 0; col < array [row] .length; col++) 
System. out. print (array [row] [col] + " "); 

System. out. println (""); 



System. out. println (""); 

} 

} 
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OUTPUT 



TableDemo produces the following output: 
1 2 3 
4 5 6 

1 2 3 
4 5 6 



1 2 3 
4 5 6 

Examine the array parameter in TableDemo's dump( ) method. Notice that 
array, length returns the number of row elements, and array [now] .length 
returns the number of column elements for a specific row. What does that 
tell you? Each row is capable of having a different number of columns. 
When a table has a different number of columns for each row, that table is 
known as a ragged array. A ragged array is illustrated in Figure 13.4. 



Columns 





(0, 0) 


(0, 1) 


(0,2) 




Rows 


(1,0) 


(1,1) 


(1,2) 


(1,3) 




(2, 0) 


{2, 1) 





Element position: (row, column) 



Figure 13.4: A ragged array offers a different number of columns for 
each row. 



A ragged array is useful in that it saves memory: Memory is required only 
for those elements that contain a nondefault value. And where might that 
capability be useful? Think about spreadsheets. Suppose a spreadsheet 
offers 10,000 rows by 10,000 columns. If all the cells in that spreadsheet 
were stored in memory (and assuming each cell required a single byte of 
storage, which is a very conservative estimate), 100 million bytes would 
(conservatively) be required to hold the entire spreadsheet in memory. Most 
personal computers would not be up to that task. However, if only those 
cells that are in use are allocated memory (by way of a ragged array), per- 
sonal computers can support the 10,000-row by 10,000-column virtual view 
in much less than 100 million bytes. 
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Arrays are Objects 

Arrays are objects. They have a length field and inherit Object's eleven 
methods. Arrays also override Object's clone ( ) method — to allow an array to 
be shallowly cloned. 



CAUTION 

Do not confuse length with length ( ) . The length field returns the number of ele- 
ments in a one-dimensional array, whereas the length {) method returns the number of 
characters in either a String object or a StringBuff er object. Mixing length and 
length 0 leads to compiler errors. 




EXAMPLE 



Calling an array's inherited methods is not a difficult task, as the following 
code fragment attests: 



int [] X = 


{ 1, 2, 3 


^; 


int [] y = 


{ 1, 2, 3 


^; 


System. out 


println (x 


toString 


System. out 


println (x 


getClass 


System. out 


println (x 


equals (y 



If you execute the code fragment, you will see output similar to the 
following: 

[I@2a340e 
class [I 
false 

As you can see, the equals ( ) method does not compare the contents of two 
arrays — only their references. That makes equals () less than desirable for 
comparing arrays. 

TIP 

In source code, it is better to specify .length instead of the array's actual length. By 
specifying .length, you don't run the risk of introducing length-related bugs into your 
code if you later change the size of the array 



Because arrays are objects, they are allocated memory from the JVM's 
heap. The Runtime class (located in the java.lang package) declares a pair of 
methods that return the total and free size of that heap: totalMemory ( ) and 
f reeMemory( ). Using those methods, you can perform experiments to learn 
how much heap memory is assigned to an array. Before you can call either 
method, you need a Runtime object reference. The easiest way to get that 
reference is to call Runtime's getRuntime( ) method. 
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The following code fragment demonstrates calls to the preceding three 
methods, which are part of a heap size measurement experiment: 
Runtime rt = Runtime. getRuntime {); 

long tm1 = rt.totalMemory (); 
long fm1 = rt.f reeMemory (); 

int [ ] X = new int [0] ; 

long tm2 = rt.totalMemory (); 
long fm2 = rt.f reeMemory (); 

System. out. println ("tm = " + tn1 + ", fm = " + fn1); 
System. out. println ("tm = " + tn2 + ", fm = " + fm2); 

To perform a heap size measurement experiment, convert the code frag- 
ment into an application and comment out the line that starts with int [ ] 
X. Run the program and record both free memory values. (They will proba- 
bly be the same.) Remove the comment and run the program a second time. 
Record both free memory values. Change the 0 to 1 in new int [0] and per- 
form another run. Record resulting free memory values and continue, by 
changing 1 to 2. Keep going until you've recorded several values. 

For each run, you can determine how much memory was allocated to the 
array, by subtracting the second free memory value from the first value. 
Subtract the amount of array memory from that value. (Keep in mind that 
a Java integer occupies four bytes.) The resulting figure represents over- 
head, where four of those bytes are dedicated to an array's length field and, 
under SDK 1.4, eight bytes are dedicated to an object. After those values 
are subtracted from the overhead, the result (under SDK 1.4 on a Windows 
98 SE platform) toggles between zero bytes (for odd allocations, such as new 
int [3]) and four bytes (for even allocations, such as new int [4]). What 
accounts for those four extra bytes? It appears that the SDK 1.4 JVM mem- 
ory manager allocates memory in eight-byte chunks. For an odd number of 
elements, all of that memory is used. For an even number of elements, 
there will always be an extra four bytes of unused memory. 

What is the point of the exercise? The exercise provides insight into Java's 
memory management, which can be helpful in a situation where you are 
tr3dng to understand why your program is running out of memory. 

Bitsets 

On occasion, you might need a data structure that associates indexes with 
true/false values. Such a data structure is known as a bitset. A bitset con- 
sists of an expandable bit sequence. Each bit has its own zero-based index 




EXAMPLE 
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and is in one of two states — true or false. The class library's BitSet class 
(located in the java.util package) represents bitsets at the source code 
level. 

To initialize a bitset, call either of two constructors: BitSet ( ) or BitSet (int 
size). The BitSet ( ) constructor initializes a bitset with a default size of 64 
bits (under SDK 1.4). In contrast, BitSet (int size) initializes a bitset with 
size bits. (The value passed in size must not be negative. Otherwise, a 
NegativeArraySizeException object is thrown.) In either case, all bits default 
to a false state, and the bitset automatically grows if an attempt is made to 
access a nonexistent bit, by specifying a positive index that equals/exceeds 
the bitset's current size. 

When you have a BitSet object, you can call various BitSet methods to 
manipulate that object. Apart from those methods that BitSet inherits from 
Object, Table 13.1 presents all of BitSet's methods. 

Table 13.1: BitSet Methods 

Method Description 

Perform a bitwise AND operation on the current bit- 
set and the bitset referenced by bs. The current bit- 
set reflects the result. 

Clear each bit, in the current bitset, whose corre- 
sponding bit is set, in the bitset referenced by bs. 
Clear the bit, located at index bitlndex, in the cur- 
rent bitset to false. 

Return the true/false setting of the bit, located at 
index bitlndex, in the current bitset. 
Return the logical size of the current bitset. The logi- 
cal size is equal to the index of the highest set bit, 
plus one. If no bits are set, zero returns. 
Perform a bitwise OR operation on the current bitset 
and the bitset referenced by bs. The current bitset 
reflects the result. 

Set the bit, located at index bitlndex, in the current 
bitset to true. 

Return the total number of bits used to represent 
the current bitset. 

Perform a bitwise XOR operation on the current bit- 
set and the bitset referenced by bs. The current bit- 
set reflects the result. 

Having a set of bits is helpful in determining whether an integer is prime 
(only divisible by one and itself). Such integers are known as prime num- 
bers and are useful in the field of cryptography. One technique for deter- 
mining whether an integer is prime was developed by the ancient Greeks 



void and(BitSet bs) 

void andNot (BitSet bs) 
void clear(int bitlndex) 
boolean get(int bitlndex) 
int length 0 

void or{BitSet bs) 

void set(int bitlndex) 

int sizeO 

void xor(BitSet bs) 




EXAMPLE 
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and is known as The Sieve of Eratosthenes. That technique (expressed in 
computational terms) works through the process of ehmination, as follows: 

• Create a bitset of a specific size. All indexes greater than one and less 
than that size will be tested to see whether they are prime. 

• Set all bits to true. Indexes associated with true bits are assumed to 
be prime. That is the default scenario. 

• Calculate the square root of the bitset's size and convert the result to 
an integer. That value is one greater than the last bit index to check. 

• Create an outer loop that iterates over all bits. The loop begins at 
index 2, because index 1 is considered to be prime and ends with one 
less than the last bit index. 

• For each bit that is true, execute an inner loop. There is no point in 
executing that inner loop if the bit is false. The reason: A false bit 
identifies a nonprime number. 

• Create an inner loop that begins at an index that is twice that of the 
outer loop index. Furthermore, the inner loop must terminate when its 
index equals the bitset's size. Finally, the inner loop's index incre- 
ments in multiples of the outer loop index. For example, if the outer 
loop index is currently 3, the inner loop index will begin at 6 and 
increment in multiples of 3. 

• For each inner loop iteration, clear the indexed bit to false. That clear- 
ing identifies that bit as nonprime. 

When the technique completes, indexes corresponding to true bits are 
prime. The PrimeTest source code in Listing 13.5 demonstrates the use of 
bitsets to implement that technique. 

Listing 13.5: PrimeTest .] ava. 
// PrimeTest. Java 

import java.util.BitSet; 

class PrimeTest 
{ 

public static void main (String [] args) 
{ 

// Examine all integers between 2 and 512, 
// to see which integers are prime. 



BitSet bs = new BitSet (512); 
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Listing 13.5: continued 

int size = bs.size () ; 

for (int i = 1; i < size; i++) 
bs.set (i); 

int lastBitlndex = (int) Math.sqrt (size); 

for (int i = 2; i < lastBitlndex; i++) 
if (bs.get (i)) 

for (int i = 2 * i; j < size; j += i) 
bs. clear (j); 




EXAMPLE 



for (int i = 1; i < size; i++) 
if (bs.get (i)) 

System. out. println (i); 

} 

} 

PrimeTest uses the process of elimination to determine which numbers from 
2 to 511 are prime. There is no point in determining whether 1 is prime, 
because that number is prime (by definition). Also, it is not necessary for 
the outer loop to iterate past lastBitlndex-l because all indexes past 
lastBitlndex -1 are multiples of indexes prior to that value and will have 
been eliminated when the outer loop reaches lastBitlndex. 

✓ PrimeTest mai<es use of Math's sqrt() metlnod. To learn more about Math, see 
"Essential Math Classes," p. 589. 

Developers new to the BitSet class often want to know how to convert the 
true/false values in a BitSet object to a sequence of I's and O's that are 
stored in an integer array. Listing 13.6's BitSetToBits source code shows 
how to accomplish that task. 

Listing 13.6: BitSetToBits. Java. 
// BitSetToBits. Java 



import java.util.*; 



class BitSetToBits 
{ 

public static void main (String [] args) 
{ 

BitSet bs = new BitSet () ; 
bs.set (31); 
bs.set (15); 
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Listing 13.6: continued 
bs.set (8); 

int [] intArray = bits2Ints (bs); 

for (int i = 0; i < intArray. length; i++) 

System. out. println (toBinary (intArray [i])); 

} 

static int [] bits2Ints (BitSet bs) 
{ 

int [] temp = new int [bs.size () / 32]; 

for (int i = 0; i < temp. length; i++) 
for (int i = 0; i < 32; 

if (bs.get (i * 32 + ])) 
temp [i] 1= 1 « i; 

return temp; 

} 

static String toBinary (int num) 
{ 

StringBuffer sb = new StringBuffer (); 

for (int i = 0; i < 32; i++) 
{ 

sb. append {({num & 1) == 1) ? '1' : '0'); 
num »= 1 ; 

} 

return sb. reverse ().toString {); 

} 

} 

When run, BitSetToBits produces the following output: 

1 0000000000000001 0000001 00000000 
00000000000000000000000000000000 



The output might look a little surprising. After all, the highest set bit (in 
OUTPUT the bitset) is bit 31, and a 32-bit integer (as expressed in source code by 
int) has only 32 bits. From where did the second line originate? If you 
examine the source code to the BitSet class, you will notice that it repre- 
sents bits using an array of long (64-bit) integers, and the size() method 
returns the length of that array multiplied by 6. As a result, bitsets default 
to a minimum size of 64 bits. 
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Now that you know why there are two hnes of output, you might be curious 
as to how the program works. To begin, BitSetToBits ' main( ) method cre- 
ates a BitSet object and sets bits 31, 15, and 8 in that object to true. That 
method then calls bits2lnts(BitSet bs) with a reference to the BitSet object 
passed in bs. The bits2lnts (BitSet bs) method converts the contents of the 
object referenced by bs to an array of 32-bit integers and returns a refer- 
ence to that array. For each element in that array, main( ) calls toBinary(int 
num) to convert the value of that element to a string of binary digits, which 
subsequently prints. 

The bits2lnts(BitSet bs) method begins by determining the size of an 
array of integers. Each bit of each integer will hold the corresponding 
true/false value of a bit in the BitSet object referenced by bs. The number of 
integers is found to be bs . size ( ) / 32. A pair of For loop statements result 
in calls to BitSet's get(int bitlndex) method to determine whether a bit is 
true or false. If true, the corresponding bit in the integer array is set to one. 
The manner by which the bit is set to one might seem a bit tricky. So as not 
to disturb other set bits in an integer, | = 1 « j is used. The value in j 
determines how many positions, to the left, to shift 1, and the resulting 
value ors with the integer's contents. If false, nothing needs to be done 
because each integer in a newly allocated array defaults to zero. Once the 
loops complete, a reference to the array returns. 

The toBinary(int num) method creates a StringBuffer object and, for each 
bit shifted into num's rightmost position, appends either character 1 or char- 
acter 0 to the string buffer. For each interation, num »= 1 ; divides the con- 
tents of num by 2 so that the next-to-rightmost bit becomes the rightmost bit 
in the next iteration. When the loop finishes, StringBuff er's reverse ( ) 
method is called to reverse the order of the StringBuffer object's contents, 
so the character representing the leftmost bit is at index 0 in the string 
buffer. Finally, StringBuff er's toString() method is called to convert the con- 
tents of the StringBuffer object to a String object. A reference to the String 
object returns. 

Enumerations 

Various data structures, such as those data structures managed by the 
Hashtable and Vector classes, are capable of storing multiple objects. Some 
mechanism is needed to examine all stored objects. Otherwise, what's the 
point of storing those objects in the first place? In other words, it is often 
necessary to enumerate over all objects stored in another object's data 
structure. Although the enumeration task is common to many data struc- 
tures, enumeration details often differ. With that in mind, Java's designers 
invented the Enumeration interface (located in the java.util package). Each 
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class that provides an enumeration service should implement Enumeration — 
to be consistent. 

The Enumeration interface provides methods hasMoreElements( ) and 
nextElement(). Those methods are designed to work as follows: the 
hasMoreElements( ) method returns a Boolean true value if there is another 
object (known as an element) to be retrieved, and a call to the nextElement( ) 
method retrieves that object. If there are no more objects, hasMoreElements( ) 
returns false, and any further calls to nextElement( ) cause it to throw a 
NoSuchElementException object. 

Data structure classes that support enumerations provide a method to 
retrieve an enumeration. When that enumeration has been retrieved, the 
hasMoreElements ( ) and nextElement ( ) methods can be called (in a loop) to 
iterate over all contained objects. 

NOTE 

After an enumeration has been used to iterate over a data structure's objects, it cannot 
be restarted for a second iteration. Instead, a new enumeration must be obtained. 



Hashtables 

The concept of association is prevalent in our world. An employee number 
associates with an employee name and address. A particular vehicle associ- 
ates with a license plate number. And there are many other examples. The 
array data structure is capable of handling associations: It associates 
indexes with element values. The advantage to using arrays for handling 
associations is rapid access. No time-consuming search is required to obtain 
a value. When handed an index, an array immediately returns the value 
from the element located at that index. Unfortunately, there is also a down- 
side to using arrays for association purposes: the occasional need for huge 
arrays. 

Suppose you are asked to write a program that quickly prepares a report 
for the Internal Revenue Service. That report must provide information on 
all 5000 employees in your company. You decide to associate a nine-digit 
social security number (SSN) with an Employee object, for simplicity and fast 
access to Employee objects. Because an SSN is (essentially) an integer, the 
SSN can be used as an index into that array. The problem with that solu- 
tion is one billion potential SSNs, which means you need an array with one 
billion entries. It is doubtful that you would find anything less than a 
supercomputer with that much memory. In addition, because you need only 
5000 array elements, the one-billion element array is extremely wasteful of 
memory. 
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The hashtable data structure offers an effective compromise to the "need for 
fast array access versus a huge array" problem. A hashtable consists of key- 
value pairs, where the key is an identifier that uniquely identifies a value. For 
example, an employee number uniquely identifies an employee. Hashtables 
map keys to array indexes, by using a process called hashing. Hashing takes 
the key and scrambles its bits so that the resulting value can be used as an 
array index. Given that array index, it is a simple matter to retrieve the value. 

NOTE 

Hashing accomplishes its task by using what is known as a hash function. A hash func- 
tion is any kind of one-way mathematical operation that converts a key's numeric repre- 
sentation to an index. That conversion maps from a larger domain of key values to a 
narrower range of index values. Because a key's numeric representation is converted to 
an index, a key can be anything (such as a sequence of characters — or even an object). 

If only hashing was that simple! Consider mapping one billion SSNs to 
5,000 indexes. It should be obvious that 200,000 SSNs will map to the same 
index. Given all those collisions, how can we uniquely map an SSN to an 
array element? To deal with collisions, a hashtable considers each array 
element as the head of a linked list data structure. That element is known 
as a bucket. To store a value, the hashtable hashes a key to an array index 
and searches the linked list, referenced by that index's associated bucket, 
for an entry that contains that key. If an entry is found, that entry's value 
is updated. Otherwise, a new entry is created and appended to the list. 
For retrieval purposes, a hashtable hashes a key into an array index and 
searches the bucket's associated linked list for an entry that contains 
that key. If an entry is found, that entry's value returns. Otherwise, null 
returns. A hashtable's search for a linked list entry is known as linear 
probing. Figure 13.5 offers a conceptual view of a hashtable. 



Indexes 



Buckets 




Note: 1 . Each set of diagonal lines indicates a null reference. 
2. f(key) = index 



Figure 13.5: A hashtable consists of a bucket array, where each entry 
serves as the head of a linked list. 
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Figure 13.5 presents the notation, f (key) = index. That notation indicates 
that a hash function is appHed to a key and that the result of that function 
is an array index. 

The class library's Hashtable class (located in the java.util package) repre- 
sents hashtables at the source code level. To initialize a hashtable, call any 
of three constructors: Hashtable(), Hashtable (int initialCapacity), or 
Hashtable(int initialCapacity, float loadFactor) . The Hashtable () con- 
structor initializes a hashtable with a default initial capacity and a load 
factor set to 0.75. If you want to specify an initial capacity, call Hashtable 
(int initialCapacity), with a suitable initialCapacity value. The default 
0.75 load factor is also used. Finally, to have complete control over 
initial capacity and load factor, call Hashtable (int initialCapacity, float 
loadFactor) with appropriate values in initialCapacity and loadFactor. The 
initialCapacity argument must be greater than or equal to 0. Similarly, 
loadFactor must be greater than or equal to 0.0. If either rule is violated, 
the latter two constructors throw lllegalArgumentException objects. 

What do initial capacity and load factor mean? The initial capacity is the 
initial number of buckets — array elements — in a hashtable. The load factor 
measures how full a hashtable is allowed to get (that is, how many buckets 
can be occupied) before the capacity is allowed to increase. By default, 
when a hashtable is 75 percent full (as indicated by a 0.75 load factor), the 
hashtable increases. That increase takes place by an internal call to a 
Hashtable object's protected rehash () method. The initial capacity and load 
factor control tradeoffs between wasted bucket space versus more frequent 
collisions and time-consuming rehash operations versus increased search 
times for long linked lists. 

When you have a Hashtable object, you can call various Hashtable methods 
to manipulate that object. Table 13.2 presents only those methods that are 
not inherited from Object and that have always been a part of Hashtable. 

Table 13.2: Hashtable Methods 

Method Description 

boolean contains (Obj ect value) Return true if the current hashtable contains at 

least one key that maps to value. 

Enumeration elements () Return an enumeration of the current hashtable's 

values. 

Object get(Obiect key) Return the value mapped to key. If there is no such 

value, null returns. 

boolean isEmptyO Return true if the current hashtable is empty (that 

is, there are no key-value mappings in the 
hashtable). 
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Table 13.2: continued 



^ \ I / 



EXAMPLE 



Method 



Description 



Enumeration keys() 

Object put(Obiect key, 
Object value) 

Object remove (Object key) 



int sizeO 



Return an enumeration of the current hashtable's 
keys. 

Map value to key in tine current liaslitable and 
return tlie previous value mapped to key (or null if 
there was no previous value). 

Remove the key-value mapping identified by key from 
the current hashtable and return key's value (or null 
if there was no value). 

Return the number of key-value mappings in the cur- 
rent hashtable. 

This section discussed mapping SSNs to indexes. Because Hashtable recog- 
nizes any object as a key, you can represent SSNs as String objects. Take a 
close look at the HashDemo source code in Listing 13.7, and you'll see that is 
exactly what that program does. 

Listing 13.7: HashDemo. java. 
// HashDemo. java 

import java.util.*; 

class Employee 
{ 

private String name; 
private double salary; 

Employee (String name, double salary) 



} 



this. name = name; 
this. salary = salary; 



String getName 
{ 

return name; 

} 



double getSalary () 
{ 

return salary; 

} 
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Listing 13.7: continued 
class HashDeno 
{ 

public static void main (String [] args) 
{ 

Hashtable ht = new Hashtable {); 



Employee e = new Employee {"John Doe", 50000.0); 
ht.put ("123-45-6789", e); 

e = new Employee ("Jim Smith", 30000.0); 
ht.put ("999-99-9999", e) ; 

e = new Employee ("Jane Smith", 49750.0); 
ht.put ("999-99-9999", e); 



} 

} 



Enumeration enum = ht.keys (); 
while (enum.hasMoreElements ()) 
{ 

String ssn = (String) enum.nextElement (); 
e = (Employee) ht.get (ssn); 
System. out. println (ssn -i- " " -i- e.getName () 
e.getSalary ()); 

} 



HashDemo calls Hashtable's put( ) method to put an Employee object into a 
hashtable, and Hashtable's get() method to retrieve the Employee object. In 
either case, an Employee object associates with an SSN. When run, HashDemo 
produces the following output: 

999-99-9999 Jane Smith 49750.0 
123-45-6789 John Doe 50000.0 



The output shows a couple of things. First, the last item placed into the 
OUTPUT hashtable is the first item retrieved. As a result, you should not assume 
any particular ordering of key-value pairs that are stored in a hashtable. 
Second, the fact that Jim Smith (and his associated salary) does not appear 
indicates that Jim Smith's Employee object was overwritten by Jane Smith's 
Employee object. That happened because both objects are associated with the 
same SSN, and a hashtable does not create a new key-value entry if it finds 
an existing entry with a matching key. Instead, that entry's value is 
replaced. 
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NOTE 

What hash function do get ( ) and put ( ) use to hash an object into an index? The 
answer: Those methods call an object's hashCode{) method. If you recall, every object 
inherits that method from the Object class. 



Properties 

It is often convenient to have a simple mechanism for storing and retriev- 
ing configuration information. Anyone famihar with the Windows INI file 
format can attest to that fact. Java supports configuration information stor- 
age and retrieval, by way of its properties data structure — a data structure 
that contains zero or more properties. Each property is stored as a key- 
value pair. 

Properties are stored in an object created from the Properties class (located 
in the java.util) package. Because Properties extends the Hashtable class, a 
Properties object is really a hashtable (in disguise). The main differences 
between Properties and Hashtable are: You store properties with the 
setPropertyO method (instead of put()) and retrieve properties with either 
of the two overloaded getProperty ( ) methods (instead of get()); and proper- 
ties contained in a Properties object can be saved to a file or some other 
storage medium — a Properties object can also retrieve a saved group of 
properties. 

CAUTION 

Do not use the put ( ) or get ( ) methods to store and retrieve properties. Those meth- 
ods encourage the storage and retrieval of arbitrary objects. If any object apart from a 
String object is stored, Properties will prevent those objects from being saved to any 
storage medium. 

To initialize a Properties object, call either of the Properties ( ) or 
Properties (Properties defaults) constructors. The Properties () constructor 
initializes a Properties object with no properties. In contrast, the 
Properties (Properties defaults) constructor initializes a Properties object 
with no properties and a default properties group. If either of Properties' 
getProperty ( ) methods cannot find a property in the current Properties 
object, that method will recursively search for the property in the 
Properties object referenced by defaults. 



Except for inherited methods, Table 13.3 presents a complete list of meth- 
ods declared in Properties. 
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Table 13.3: Properties Methods 




EXAMPLE 



Method 



Description 



string getProperty (String key) 

String getProperty (String 
key, String def aultValue) 

void list (PrintStream ps) 

void list (PrintWriter pw) 

void load ( InputStream is) 

Enumeration propertyNames ( ) 

Object setProperty (String 
key, String value) 

void store (OutputStream os, 
String header) 



Search the current properties for an entry whose key 
matches key. Return null if the entry is not found. 
Search the current properties for an entry 
whose key matches key. Return def aultValue if the 
entry is not found. 

Print the current properties in a key=value format to 

the print stream identified by ps. 

Print the current properties in a key=value format to 

the print writer identified by pw. 

Load a list of key-value pairs, from the input stream 

identified by is, into the current properties. 

Return an enumeration of all keys in the current 

properties. 

Set the property identified by key to value. 
This method directly calls the inherited put() 
method. 

Write the current properties to the output 
stream identified by os, along with a header that 
describes those properties. Properties are written in 
a format that allows them to be read by the load ( ) 
method. 



NOTE 

The store ( ) method writes properties to a file using a text format. The first two written 
lines consist of a header followed by the current date and time. Each of those lines 
begins with a # character that identifies the line as a comment, and not a property 

To give you a feel for working with properties, Listing 13.8 presents source 
code to the PropDemo apphcation. PropDemo creates a Properties object, stores 
several properties in that object, saves those properties to a file, creates a 
second Properties object, loads the saved properties into that object, and 
lists that object's properties to the standard output device. 

Listing 13.8: PropDemo. java. 
// PropDemo. java 



import java.io.*; 

import java.util. Properties; 



class PropDemo 
{ 

public static void main (String [] args) 
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Listing 13.8: continued 
{ 

Properties p = new Properties (); 
p.setProperty ("ScreenX", "200"); 
p.setProperty ("ScreenY", "500"); 
p.setProperty ( "ScreenWidth" , "1024"); 
p.setProperty ("ScreenWidth", "768"); 
saveProperties (p); 

Properties p2 = new Properties (); 
loadProperties (p2); 
p2.1ist (System. out) ; 



static void loadProperties (Properties p) 
{ 

FilelnputStream fis = null; 

try 
{ 

fis = new FilelnputStream ("myprops.txt"); 
p. load (fis); 

} 

catch (lOException e) 
{ 

System. out. println ; 

} 

finally 
{ 

if (fis != null) 

try { fis. close (); } catch (lOException e2) {} 

} 

} 

static void saveProperties (Properties p) 
{ 

FileOutputStream fos = null; 

try 
{ 

fos = new FileOutputStream ("myprops.txt"); 
p. store (fos, "My Header"); 

} 

catch (lOException e) 
{ 

System. out. println ; 
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OUTPUT 



Listing 13.8: continued 
} 

finally 
{ 

if (fos != null) 

try { fos. close (); } catch (lOException e2) {} 

} 

} 

} 

PropDemo produces the following output: 

-- listing properties -- 
ScreenWidth=768 
ScreenY=500 
ScreenX=200 

✓ To perform its tasks, PropDemo makes use of streams, specifically: FilelnputStream, 
FileOutputStream, and System. out. To learn more about streams, see "Working with 
Streams," p. 634. 

System Properties 

Many Microsoft Windows users are familiar with the concept of environ- 
ment variables. That term is also used in the Unix world. An environment 
variable is much like a property: a l<ey=value association. Because Java 
aims to be portable across platforms, it does not expose developers to a 
platform's environment variables. Instead, Java allows developers to access 
system properties. Those properties are carefully selected so they can be 
accessed in a platform-independent fashion. Examples of system property 
names include os.name (the operating system name), java. version (the ver- 
sion of Java being used), and line, separator (the character or characters 
that terminate a line of text). 

The System class contains several methods for accessing and modifjdng sys- 
tem properties. To find out what system properties are available, try exe- 
cuting the following code fragment (after placing it into an application, of 
course): 

Properties p = System. getProperties (); 

p. list (System. out) ; // List property information to standard output. 
CAUTION 

Java considers system property access to represent a potential security risk. Therefore, 
only applications that haven't voluntarily given up security rights are allowed access to 
system properties. 
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Stacks 

When you enter a cafeteria, you typically pick up a tray from the top of a 
clean tray stack, get your food, eat, and return the tray to the top of a dirty 
tray stack. In a sense, you pop the clean tray from the top of the clean tray 
stack and push the dirty tray onto the top of the dirty tray stack. A cafete- 
ria worker will place a clean tray onto the top of the clean tray stack (a 
push) and remove the dirty tray from the top of the dirty tray stack (a pop) 
for washing. In computer terms, a stack consists of an object sequence. 
Objects are pushed onto and popped from the stack's top. The last item 
pushed is the first item popped. As a result, stacks are last-in/first-out 
(LIFO) data structures. To see an example of how a stack works, check out 
Figure 13.6. (The vertical downward-pointing arrow beside each stack indi- 
cates that items are pushed down, to make room for a new item.) 



top 



#5 



top 



> 






#6 




#5 



A) Before pushing item #6. 



B) After pushing item #6. 



top 



#5 



top 



C) After popping top item #6. 



D) After popping top item #5. 



Figure 13.6: A stack pops the last pushed item: A) current top item #5, 

B) after pushing item #6 — which becomes the new top item, C) after popping 

item #6, and D) after popping top item #5. 

Java's Stack class (located in the java.util package) represents a stack in 
source code. To initialize a Stack object that is initially empty, call the 
Stack 0 constructor. Call the push() method to push items onto that stack 
and pop ( ) to pop items from the stack. 

Stack inherits many methods from Vector and other classes. Table 13.4 pre- 
sents only those methods unique to Stack. 



16 71710_CH13 11/21/01 4:26 PM Page 52E 



528 Chapter 13: From Fundamental Data Structures to Collections 



Table 13.4: Stack Methods 



EXAMPLE 



Method 



Description 



boolean empty () 
Object peek() 
Object popO 

Object push(Object item) 
int search (Obj ect o) 



Test the stack to see whether it is empty. If empty, 
true returns. 

Return a reference to the object on the top of the 
stacl<, without removing that object. 
Return a reference to the object on the top of the 
stacl< and remove that object. 
Push the object referenced by item onto the stack's 
top, and return item. 

Search the stack for the object referenced by o. If 
not found, -1 returns. Otherwise, a one-based num- 
ber returns, which identifies the object's distance 
from the stack's top. (One means that the object is 
at the top, two means that the object is next to the 
object at the top, and so on.) 

The stackDemo source code in Listing 13.9 demonstrates a stack's LIFO 
capability. That apphcation accepts a sequence of command-hne arguments 
and pushes each argument onto a stack. Later, those arguments are popped 
off and printed. In a nutshell, StackDemo reverses a sequence of strings. 

Listing 13.9: StackDemo. Java. 
// StackDemo. Java 

import java.util. Stack; 

class StackDemo 
{ 

public static void main (String [] args) 
{ 

Stack s = new Stack ( ) ; 

for (int i = 0; i < args. length; i++) 
s.push (args [i]); 



while (!s. empty ()) 

System. out. println (s.pop ()); 



OUTPUT 



} 

If you were to run StackDemo (after compiling StackDemo. java into 
StackDemo. class) by issuing java StackDemo First Second Third, you would 
see the following output: 

Third 

Second 

First 
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Vectors 

The problem with arrays is that they are fixed: After an array is created, it 
cannot be resized. To deal with that limitation, the vector data structure 
was introduced into Java. A vector consists of an expandable array of 
objects. The class library's Vector class (located in the java.util package) 
represents vectors at the source code level. 

A Vector is initialized by calling one of three constructors: Vector( ), 
Vector(int initialCapacity), and Vector (int initialCapacity , int 
capacitylncrement). Each Vector constructor specifies either a default capac- 
ity (the total number of elements in a vector's internal array) or an explicit 
capacity, by way of the initialCapacity argument. Because a vector is 
expandable, the capacitylncrement argument determines how many addi- 
tional array elements are required when the vector's capacity is reached. 
The Vector 0 constructor chooses a default capacity of 10 and a capacity 
increment of zero. That increment causes the array to double in size when 
the capacity is reached. 



TIP 

To increase the capacity of a vector, a Vector object must allocate memory for a new 
array and copy the contents of the old array into that new array. That activity takes 
time. Choosing appropriate values for initialCapacity and capacitylncrement can 
boost your program's performance: The larger the values you choose, the fewer the 
number of times the Vector's internal array will need to be resized and copied. 
However, choosing values that are too large wastes memory. Therefore, you might want 
to play around with different values when analyzing your program, to determine an 
appropriate initial capacity and capacity increment. 



In addition to capacity, vectors also have the notion of size. A vector's size is 
the number of elements currently stored. The size is always less than or 
equal to the capacity and can be obtained by calling the size() method. 
For a description of size( ) and other methods specific to Vector, check out 
Table 13.5. 

Table 13.5: Vector Methods 

Method Description 

void addElement (Obj act o) Append the object referenced by o to the current 

vector. The vector's size increases by one. 

int capacity {) Return the vector's current capacity. 

Object elementAt (int index) Return a reference to the object located at index. If 

index is negative or equals/ 
exceeds the vector's size, throw an 
Ar ray I ndexOu tot Bounds Except ion object. 
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Table 13.5: continued 



Method 



Description 



Enumeration elementsO 



void ensureCapacity (int 
mincapacity) 



Objeot f irstElement ( ) 



void insertElementAt 
(Object 0, int index) 



Object lastElement ( ) 



boolean removeElement 
(Object 0) 



void removeElementAt 
(int index) 



void setElementAt 
(Object 0, int index) 



void setSize{int newSize) 



int sizeO 



Return a reference to an object that implements 
Enumeration and is used to enumerate all objects 
contained in the current vector. 
Increase the current vector's capacity to 
mincapacity, if the capacity is less. That operation 
can be time-consuming, when it results in a new 
internal array being allocated and element values 
copied from the old array to the new array. 
Return a reference to the first element in the current 
vector (the element at index 0) or throw a 
NoSuchElementException object if the vector is 
empty. 

Insert the object referenced by o into the 
current vector at the position specified by index. All 
objects located at that index and greater indexes are 
moved one position upward, to make room. If index 
is negative or equals/exceeds the vector's size, 
throw an ArraylndexOutOf BoundsException object. 
Return a reference to the last element in the current 
vector (the element at index size ( ) - 1 ), or throw a 
NoSuchElementException object if the vector is 
empty. 

Remove the first (lowest-index) occurrence of 

the object referenced by o from the current vector. 

Return true if the object was found and removed. 

Othenwise, return false. 

Remove an object, located at the position 

specified by index, from the current 

vector. If index is negative or equals/ 

exceeds the vector's size, throw an 

ArraylndexOutOf BoundsException object. 

Replace the object, located at the position 

specified by index, in the current vector, with the 

object referenced by o. If index is negative or 

equals/exceeds the vector's size, throw an 

ArraylndexOutOf BoundsException object. 

Set the size of the current vector to newSize. If 

newSize is negative, throw an 

ArraylndexOutOf BoundsException object. 

Return the number of objects in the current vector. 
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Table 13.5: continued 




EXAMPLE 



Method Description 



void trimToSizeO Trim the current vector's capacity to its size. If tine 

current capacity exceeds its size, tine internal array 
is replaced. Use trimToSize( ) to reduce the 
amount of storage allocated to a vector. 

In some applications, it is necessary to read a variable number of strings 
from a text file. Suppose you have a text file containing stock information 
for a variety of companies, and you want to create an application for view- 
ing that information. Assume that each line in the text file contains stock 
information for a specific company, and that the information consists of that 
company's stock symbol, share price, change in share price, and volume 
traded for a single day. You don't know how many companies are repre- 
sented in the text file. Therefore, you might consider reading all lines of 
information into a vector. Later, you access that information by calling 
Vector^'s methods. To give you a hand with the solution. Listing 13.10 pre- 
sents source code to the StockViewer application. 

Listing 13.10: StockViewer. java. 
// StockViewer. Java 

import java.io.*; 
import java.util.*; 

class StockViewer 
{ 

public static void main (String [] args) 
{ 

Vector stocks = new Vector {); 



Buff eredReader br = null; 



try 
{ 

FileReader fr = new FileReader ("stocks.dat"); 
br = new Buff eredReader (fr); 

String stock; 

while ((stock = br.readLine ()) != null) 
stocks. addElement (stock); 

} 

catch (lOException e) 
{ 
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Listing 13.10: continued 

System. out. println ; 

} 

finally 
{ 

if (br != null) 

try { br. close (); } catch (lOException e2) {} 

} 

Enumeration e = stocks. elements (); 
while (e.hasMoreElements {)) 

System. out. println (e.nextElement ()); 

} 

} 

StockViewer isn't the most exciting program in the world. Instead of out- 
putting stock information to the standard output device, it would be better 
to display that information with a graphical user interface. Still, 
StockViewer demonstrates the essential task of reading all lines from a text 
file and storing them in a vector, by calling Vector's addEleinent( ) method for 
each line. Furthermore, when it comes time to view the stock information, 
an enumeration is obtained, by calling Vector's elements ( ) method. 

Don't be too concerned with the various file-related classes and method 
calls that appear in StockViewer. You'll get a chance to explore those classes 
(and methods) in a future chapter. For now, consider playing with the pro- 
gram (such as making calls to removeElementsO, to remove various objects 
from the vector) to learn more about Vector. Before you can play with 
StockViewer, you'll need some sample stock information. Listing 13.11 pre- 
sents stock information for four well-known companies. 

Listing 13.11: Sample stock information 

MSFT 65.47 -1 .12 32,702,600 
EBAY 63.60 -1 .23 3,644,600 
AMZN 12.25 -0.08 9.077,400 
SUNW 16.29 +0.20 36,133,800 



Wrappers 



In the previous chapter, you were asked the following question: What do 
Character and plastic wrap have in common? The answer: the concept of 
wrapping. Just as you wrap food in plastic wrap, you also wrap a char value 
in a Character object. For that reason. Character is known as a wrapper 
class — or wrapper, for short. 
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EXAMPLE 



Character isn't the only wrapper. Java includes wrapper classes for all eight 
primitive types. The other seven wrappers include: Boolean (for wrapping 
boolean values in Boolean objects), Byte (for wrapping byte values in Byte 
objects), Double (for wrapping double values in Double objects). Float (for 
wrapping float values in Float objects). Integer (for wrapping int values in 
Integer objects). Long (for wrapping long values in Long objects), and Short 
(for wrapping short values in Short objects). All of those classes are located 
in the java.lang package and exist for two reasons: 

• Wrapper classes are a convenient place to store various methods that 
are associated with a wrapper's primitive type. For example, integer 
specifies a toHexString( ) method for converting an int value to a 
String of hexadecimal characters. Also, Character specifies an 
isDigit ( ) method for determining whether a char value represents a 
digit. Because wrapper classes contain lots of class methods, they are 
commonly referred to as utility classes. 

• Many data structure objects, such as a vector object, are designed to 
store objects of any type: They do not store primitive values. To get 
around that limitation, wrapper classes are used to create objects that 
wrap themselves around primitive values. In turn, those wrapper 
objects can be stored in a data structure object. 

The WrapperDemo application source code in Listing 13.12 demonstrates the 
usefulness of wrappers, as utility classes and for wrapping primitive values 
in objects that are stored in a data structure object. 

Listing 13.12: WrapperDemo. java. 
// WrapperDemo. Java 



import java.util.*; 



class WrapperDemo 
{ 

public static void main (String [] args) 
{ 

System. out. println ("16055 in binary: " + 

Integer. toBinaryString (16055)); 

System. out. println ("16055 in hexadecimal: " + 

Integer. toHexString (16055)); 



Vector V = new Vector (); 
v.addElement (new Boolean (true)); 
v.addElement (new Double (3.14159)); 
V.addElement (new Integer ("75")); 
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Listing 13.12: continued 

Enumeration e = v. elements {); 

while (e.hasMoreElements {)) 
{ 

Object 0 = e.nextElement (); 

if (0 instanceof Boolean) 

System. out. println {((Boolean) o) .booleanValue ()); 

else 

if (o instanceof Double) 

System. out. println (((Double) o) .doubleValue ()); 

else 

if (0 instanceof Integer) 

System. out. println (((Integer) o).intValue ()); 

} 

} 

} 

When you run WrapperDemo, you will see the following output: 

16055 in binary: 11111010110111 

16055 in hexadecimal: 3eb7 

true 

3.14159 

75 

All wrapper classes declare a constructor that takes an argument of that 
wrapper's associated primitive type. For example, Boolean declares a 
Boolean (boolean b) constructor. With the exception of Character, all wrapper 
classes also have a constructor that takes an argument of the String type. 
That constructor is a convenience for converting between a String represen- 
tation of an argument value and the wrapper's associated primitive type. 
Care must be exercised when using that constructor. If an invalid string 
representation is specified (such as Boolean ( "null" )), either the constructor 
will throw an exception object (such as Short (String s) throwing a 
NumberFormatException object) or the constructor will ignore the argument 
and use a default value (such as Boolean ( "null" ) ignoring null and using a 
default false value). 

All wrapper classes declare one or more methods for returning a wrapper 
object's primitive value. For example, class Double declares a doubleValue ( ) 
method that returns its double-precision floating-point value. That class 
also declares byteValue(), floatValue( ), and other methods for returning 
that value as a byte integer, a floating-point value, or something else. 
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CAUTION 

A common mistake when working witin wrappers is attempting to assign a wrapper 
object reference to a variable of primitive type. For example, int i = new Integer 
(1 ) ; . That code does not compile because it is attempting to assign an Integer 
object reference to integer variable i. (A reference and an integer are two different 
things.) 



Self-Referential Classes 



What do you get when you declare a class with at least one field that uses 
the class's name as its type? The answer is: a self-referential class. Each 
object created from a self-referential class is known as a node, and each 
self-referential field is known as a link. Self-referential fields are known as 
links because you can link objects (created from the same class) together by 
assigning their references to each other's link fields. 

For your first taste of a self-referential class, examine the source code in 
Listing 13.13 for the Node class. 

Listing 13.13: Node.java. 
// Node.java 

class Node 
{ 

private Object datum; 
private Node next; 

Node (Object datum) 
{ 

setDatun (datum); 
setNext (null); 

} 

void setDatun (Object datum) 
{ 

this. datum = datum; 

} 

Object getDatum () 
{ 

return datum; 

} 




void setNext (Node next) 
{ 
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Listing 13.13: continued 

this. next = next; 

} 

Node getNext {) 
{ 

return next; 

} 

} 

Node is a self-referential class because it declares a next field of class type 
Node. When a Node object is initialized, Node's datum field is assigned an 
object reference (a reference to the node's data item), and the next field is 
assigned null, to indicate that no other node links to the current node. 
However, by calling the setNext ( ) method, it is possible to link (that is, 
attach) another node to the current node. To see how you can link nodes to 
each other, examine the following code fragment: 

Node top = null; 

for (int i = 0; i < 5; i++) 

{ 

Node temp = new Node (new Integer (i)); 
temp. setNext (top); 
top = temp; 

} 

The code fragment begins by declaring a variable that will refer to the top 
node (also known as the head node, or first node) in a linked node sequence. 
That variable is initialized to null to indicate that there is no node 
sequence. Then, five Node objects are created, where each node contains a 
reference to an integer object. Each newly created node links to the start of 
the node sequence, as follows: The current top reference is assigned to the 
newly created node's next field, by calling the Node object's setNext ( ) method 
with top as an argument, and top is set to the node's reference. To give you 
some idea of what that looks like, examine Figure 13.7. In that sequence, 
(A) top refers to an empty list, (B) one node added, a second node added, a 
third node added, the fourth node added, and (F) the node sequence is com- 
plete. The resulting node sequence is something like a stack, where the 
most recently linked node becomes the top node. 

It is common to refer to a linked node sequence as a linked list of nodes, or 
simply as a linked list. A linked list, where each node (except for the last 
node) links to the next node, is known as a singly linked list. If each node 
(except for the first node) also links to the previous node, the linked list is 
known as a doubly linked list. A third variant of linked list is known as a 
circular linked list, because the first and last nodes link to each other. 
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Circular linked lists are often used to implement a queue data structure, 
where insertions are made at one end and deletions at the other end. If you 
are not familiar with the queue concept, think of waiting in a line for a 
bank teller. That line is a queue, where you arrive at the end, slowly move 
to the front of the line, and approach the teller from the line's front. 
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Note: The picture doesn't indicate (for brevity) but a Node object's datum field references 
the Integer object, as follows: 



datum- 



^ Node object 
Integer object 



Figure 13.7: Nodes link to the front of a node sequence. 



Linked lists and arrays are the basis for complex data structures (such as 
stacks and queues). Before deciding whether to use a linked list or an 
array to implement a more complex data structure, you need to know what 
advantages arrays and linked lists offer. Linked lists have the advantage 
when it comes to quick insertions and deletions. It takes less time to insert 
or delete a node from a linked list than it does to remove an element from 
an array: Changing appropriate links is faster than shuffling array ele- 
ments to close the hole left when an element is deleted. However, arrays 
have the advantage when it comes to search time. All that is required to 
access an array element is to specify an index. In contrast, links must be 
traversed to find an appropriate node. The following code fragment tra- 
verses the previous code fragment's links to print out the contents of the 
linked list's nodes: 

Node temp = top; 
while (temp != null) 
{ 

System. out. println (temp.getDatum ().toString ()); 
temp = temp.getNext ( ) ; 

} 
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NOTE 

A tree is a common data structure in which data items are organized into a hierarchy. 
Trees are useful in programs that implement compilers, database indexes (which offer 
fast retrieval to stored data), and games (such as chess). Although trees are often 
implemented by using nodes with multiple link fields, they can also be implemented 
entirely in arrays or by using a combination of arrays and linked lists. 



Collections 



Arrays, Hashtable objects, Stack objects, and Vector objects: What do they 
have in common? Each of those objects is a collection — a container object 
capable of storing other objects. Although you can use arrays, the aforemen- 
tioned classes, and self-referential classes to implement complex data struc- 
tures in custom collection classes, there are problems with that approach: 

• You spend time focusing on writing collection classes at the expense of 
writing applications. Furthermore, when time is of the essence, collec- 
tion classes are not designed for reuse, which usually results in those 
classes needing to be retooled for the next application that needs them. 

• It takes time to learn the ins and outs of "home-grown" collection 
classes. That is especially true for someone else trying to understand 
your source code. 

• You might develop a collection class whose performance is suboptimal 
for your program, because you find it relatively easy to devise that 
collection class instead of a more complex — and better performing — 
collection class. 

In addition to those three problems, a fourth problem exists with the 
Hashtable, Stack, and Vector classes. Those classes contain many synchro- 
nized methods and synchronized blocks. Because it takes longer to call a 
synchronized method or enter a synchronized block than it does to call an 
unsynchronized method or enter an unsynchronized block, those classes' 
methods can significantly impact performance. Also, synchronized methods 
and blocks are not necessary in a single-threaded program. To overcome 
that and the other three problems. Sun has developed a collections frame- 
work that debuted as part of the SDK 1.2 release. That framework is 
known as the Collections API. 



NOTE 

Sun has retrofitted the Hashtable and Vector classes to integrate them with the 
Collections API. Although their basic functionality has not changed, those classes now con- 
tain many new methods not shown in earlier tables. Because Stack extends Vector, it has 
access to Collections API methods, even though Stack has not been explicitly changed. 
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The Collections API offers a unified architecture to simplify the representa- 
tion and manipulation of collections. To make that happen, the Collections 
API consists of interfaces, implementations, and utilities. You access a col- 
lection through well-defined interfaces. Interface usage frees you from 
implementation details and lets you easily switch from one implementation 
(such as an array-based implementation) to another implementation (such 
as a linked list-based implementation). The Collections API also provides 
one or more implementations for each interface. Each implementation 
offers some kind of performance benefit. For example, linked list-based 
implementations offer fast insertion/deletion but slow access. In contrast, 
array-based implementations offer fast access but slow insertion/deletion. 
Finally, the Collections API supplies a variety of useful operations (such as 
sort and search) that are common to many collections. Because those poly- 
morphic utilities are expressed as methods with interface parameters, they 
work consistently across a variety of interface implementations. 

TIP 

Sun's Collections API was designed with extension in mind. If that API does not meet 
all your needs, you can extend it with your own implementations. To learn how to extend 
the Collections API, visit the Collections Trail in Sun's online Java Tutorial (http: // 
java. sun . com /docs /books /tutorial /collections /index . html). 

Interfaces 

The Collections API is based on interfaces. Those interfaces make it possi- 
ble to manipulate collections and pass them among various methods in a 
polymorphic fashion. Collections API interfaces are organized in two inter- 
face hierarchies, as illustrated in Figure 13.8. 



Collection 



Map 



Set 



List 



SortedMap 



SortedSet 



Figure 13.8: The Collections API rests on a pair of interface hierarchies. 



The Collection hierarchy deals with groups of objects, whereas the Map 
hierarchy deals with mappings (associations). Each interface specifies a 
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common set of methods that can be apphed, either to a group of objects or 
to a group of mappings. Some of the methods are optional. If you decide to 
implement any of those interfaces in a new class, you are not required to sup- 
port optional methods. If you choose not to support an optional method, you 
should have that method throw an UnsupportedOperationException object. 

NOTE 

All Collections API interfaces are located in the java.util package. 

Version 1.4 of the Java 2 Standard Edition SDK introduces the RandomAccess 
interface. That interface is implemented by classes, that also implement 
the List interface, to indicate that their objects support fast constant time 
random access to list entries. As a result, when confronted by objects cre- 
ated from such classes, generic algorithms (such as a binary search algo- 
rithm) can tailor their behavior to achieve highest performance. For 
example, the algorithm can use a fast array-based implementation if it 
detects (by way of instanceof ) that an object was created from a class (such 
as ArrayList) that implements RandomAccess. Otherwise, the algorithm will 
use a slower linked-list based implementation. Many of the methods in the 
Collections class use instanceof to check if the List objects referenced from 
their arguments were created from classes that implement RandomAccess. If 
so, faster array-based implementations of those methods can be used. 

Don't worry about the aforementioned classes. You will learn more about 
ArrayList and Collections as you read this chapter. 

The Collection Hierarchy 

The Collection interface is the root interface of an interface hierarchy dedi- 
cated to grouping objects in container objects. No assumptions are made 
about the order of objects stored in a Collection and whether or not the 
Collection contains duplicates. Table 13.6 presents Collection's methods. 

Table 13.6: Collection Methods 

Method Description 

boolean add(Obiect o) Add the object referenced by o to the current collec- 

tion. Return true if the object was added or false if 
the current collection already contains the object 
and does not allow duplicates. That method is 
optional. 

boolean addAll (Collection c) Add all objects contained in the collection refer- 
enced by c to the current collection. Return true if 
the current collection changed or false if the collec- 
tion referenced by c only contains duplicates and 
the current collection does not allow duplicates. 
That method is optional. 



1.4 



16 71710_CH13 11/21/01 4:27 PM Page 541 




Collections 541 



Table 13.6: continued 



Method 



Description 



void clearO 

boolean contains (Obj ect o) 

boolean containsAll 
(Collection c) 

boolean equals(Object o) 



int hashCodeO 
boolean isEmptyO 

Iterator iterator() 



boolean remove (Obj ect o) 



boolean removeAll 
(Collection c) 



boolean retainAll 
(Collection c) 



int sizeO 



Object [] toArrayO 



Remove all objects from the current collection. That 
method is optional. 

Return true if the current collection contains the 
object referenced by o. 

Return true if the current collection contains the 
same objects as contained in the collection refer- 
enced by c. 

Return true if the object referenced by o is an object 
whose class directly or indirectly implements 
Collection and equals the current collection as far 
as contained objects are concerned. 
Return the current collection's hashcode. 
Return true if the current collection contains no 
objects. 

Return an object whose class implements the 
Iterator interface. That object can be used in a 
manner that is similar to an Enumeration object. The 
result is a mechanism for examining all objects con- 
tained in the current collection. 
Remove a single instance of the object referenced 
by 0 from the current collection. Return true if the 
object was removed. That method is optional. 
Remove all objects from the current collection that 
are also contained in the collection referenced by c. 
When the call completes, the current collection con- 
tains no objects in common with the specified col- 
lection. Return true if the collection changed as a 
result of the call. That method is optional. 
Remove all objects from the current collection that 
are not also contained in the collection referenced 
by 0. When the call completes, the current collection 
contains only objects in common with the specified 
collection. Return true if the collection changed as a 
result of the call. That method is optional. 
Return a count of all objects contained in the cur- 
rent collection. If there are more than 
Integer. MAX_VALUE objects. Integer. MAX_VALUE 
returns. {MAX_VALUE is a constant, in the integer 
class, that identifies the largest 32-bit integer 
value.) 

Return an array of references to all objects con- 
tained in the current collection. If a collection guar- 
antees an order in which objects are returned via an 
iterator, the method must return those objects in the 
same order. 
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Table 13.6: continued 

Method Description 

Object [] toArray{Object [] a) Return an array of references to all objects con- 
tained in the current collection. The array is returned 
so that its runtime type is identical to the type of a. 



NOTE 

Table 13.6 mentions the Iterator interface. That interface is similar to Enumeration. 
However, where Enumeration declares two methods (hasMoreElements ( ) and 
nextElement ( ) ), Iterator declares three methods — hasNext ( ) , next { ) , and 
remove(). The hasNextO and next{) methods are similar to Enumeration's 
hasMoreElements ( ) and nextElement ( ) methods, respectively. The remove () method 
makes it possible to remove elements during an iteration. Because that method is 
optional, an UnsupportedOperationException object is thrown from remove ( ) when 
the iterator does not support object removal. 



The Set interface derives from Collection and represents a collection that 
cannot contain duplicate objects. Set declares no additional methods and 
adds a stronger contract for the equals () and hashCodeO methods — to allow 
meaningful comparisons between Set objects with different implementa- 
tions. Two Set objects are considered equal if they contain the same objects. 

The SortedSet interface derives from Set and represents a collection 
whereby its iterator returns contained objects in some kind of order. The 
Collections API recognizes two kinds of order: natural order and compara- 
tor order. Natural order is the default internal order and comparator order 
is a developer-specified order. (You will learn more about those orders when 
utilities are explored.) SortedSet's additional methods appear in Table 13.7. 

Table 13.7: SortedSet Methods 

Method Description 

Comparator comparator () Return the current sorted set's comparator or null if 

it uses natural order. 

Object first {) Return the first (lowest) object in the current sorted 

set. 

SortedSet headSet(Object o) Return a view of the current sorted set whose con- 
tained objects are strictly less than the object refer- 
enced by 0. 

Object lastO Return the last (highest) object in the current sorted 

set. 
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Table 13. 7: continued 



Method 



Description 



SortedSet subSet (Obj ect 
from, Object to) 



SortedSet tailSet(Object o) 



Return a view of the current sorted set whose 
contained objects range from the object referenced 
by from to the object that precedes the object refer- 
enced by to. 

Return a view of the current sorted set whose con- 
tained objects are greater than or equal to the 
object referenced by o. 



NOTE 

Table 13.7 mentions the concept of a view. Think of a view as a portion of a collection. 
Although the view identifies a smaller number of objects, modifications to those objects 
affect both the view and associated collection. 



As with Set, the List interface derives from Collection. However, List rep- 
resents ordered (left-to-right) collections that can contain duplicate objects. 
Also, List introduces several additional methods that make it possible to 
manipulate objects based on their positions in a list, to search for a specific 
object based on its position, to iterate over a list using an iterator that 
takes a list's left-to-right sequential nature into account, and to perform 
operations on an arbitrary portion of a list. Table 13.8 presents List's addi- 
tional methods. 

Table 13.8: List Methods 



Method 



Description 



void add(int index, Object o) 



boolean addAll(int index, 
Collection c) 



Object get(int index) 



int indexOf (Object o) 



int lastlndexOf (Obj ect o) 



Add the object referenced by o to the current list at 
index. The object previously located at index and all 
objects to the right of that object (if any) are shifted 
one position to the right. That method is optional. 
Add all objects contained in the collection 
referenced by c to the current list beginning at 
index. The object previously located at index and all 
objects to the right of that object (if any) are shifted 
an appropriate number of positions to the right. That 
method is optional. 

Return the object from the current list that is 
located at index. 

Return the index of the first object referenced by o 
in the current list, or -1 if the current list does not 
contain that object. 

Return the index of the last object referenced by o in 
the current list, or -1 if the current list does not con- 
tain that object. 
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Table 13.8: continued 



Method 



Description 



Listlterator listlterator ( ) 



Listlterator listlterator 
(int index) 



Object remove(int index) 



Object set(int index, 
Object 0) 

List subList(int fromlndex, 
int tolndex) 



Return an object whose class implements the 
Listlterator Interface. The resulting iterator can be 
used to examine all objects in the current list, in an 
ordered sequence. 

Return an object whose class implements the 
Listlterator interface. The resulting iterator can be 
used to examine all objects, starting at index, in the 
current list, in an ordered sequence. 
Remove the object located at index from the current 
list and return a reference to that object. That 
method is optional. 

Replace the object located at index in the 
current list with the object referenced by o. That 
method is optional. 

Return a view of the current list that ranges 

from fromlndex to tolndex -1. Any changes made to 

the view are also made to the original list. 



NOTE 

Table 13.8 mentions the Listlterator interface. That interface derives from Iterator 
and makes it possible to modify a list while traversing that list in either direction (left or 
right). 



The Map Hierarchy 

The Map interface is the root interface of an interface hierarchy dedicated to 
mapping keys to values. Each mapping is known as an entry. Entries can- 
not contain dupHcate keys, and each key can associate with one and only 
one value. Table 13.9 presents Map's methods. 

Table 13.9: Map Methods 



Method 



Description 



void clear(void) 

boolean containsKey 
(Object key) 
boolean containsValue 
(Object value) 
Set entrySetO 

Object get(Obiect key) 



Remove all entries from the current map. That 
method is optional. 

Return true if the current map contains an 
entry for the specified key. 
Return true if the current map contains an 
entry for the specified value. 

Return a Set view of all entries contained in the cur- 
rent map. 

Return the current value of the entry, in the current 
map, identified by key. 



16 71710_CH13 11/21/01 4:29 PM Page 545 




Collections 545 



Table 13.9: continued 



Method 



Description 



Set keyset 0 

Object put(Obiect key, 
Object value) 



void putAll(Map t) 
Collection values{) 



Return a Set viev\/ of all keys contained in the cur- 
rent map. 

Either add a new/ entry to the current map or 
replace an existing entry. The entry is identified by 
key, and its value is identified by value. Return 
either the previous value (if the entry already exists) 
or the new value, if a new entry is being added. That 
method is optional. 

Copy all mappings from the Map object referenced by 
t into the current map. That method is optional. 
Return a collection composed of all values in the 
current map. 



Map's entr-ySetO method returns a Set of Map. Entry objects, where each object 
describes a key-value entry. The only way to access those objects is during 
an iteration, as you will see. For now, check out the various Map. Entry meth- 
ods that appear in Table 13.10. 

Table 13.10: Map. Entry Methods 



Method 



Description 



Object getKeyO 
Object getValueO 

Object setValueCObject value) 



Return the key that corresponds to the current entry. 
Return the value that corresponds to the current 
entry. 

Replace the current entry's value with value and 
return the previous value. That method is optional. 



TIP 

It might be strange to see an interface nested inside another interface. However, Java 
considers interface nesting to be just as legal as class nesting. 



The SortedMap interface derives from Map and represents a collection 
whereby its iterator returns contained objects in either natural or compara- 
tor order. SortedMap's additional methods appear in Table 13.11. 

Table 13.11: SortedMap Methods 

Method Description 

Comparator comparator () Return the current sorted map's comparator or null 

if it uses natural order. 
Object firstKeyO Return the first (lowest) key in the current sorted 

map. 

SortedMap headMap{Object o) Return a view of the current sorted map whose con- 
tained keys are strictly less than the object refer- 
enced by 0. 
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Table 13.11: continued 



Method 



Description 



Object lastKeyO 

SortedMap subMap(Object from, 
Object to) 



SortedMap tailMap{Object o) 



Return the last (highest) key in the current sorted 
map. 

Return a view of the current sorted map whose 
contained objects range from the object referenced 
by from to the object that precedes the object refer- 
enced by to. 

Return a view of the current sorted map whose con- 
tained objects are greater than or equal to the 
object referenced by o. 



Implementations 

Interfaces provide an idea of what the Collections API is capable of accom- 
plishing. Getting to know those interfaces will help you master the API. 
However, just studying interfaces is not enough. To fully understand what 
the Collections API can do for you, you need to learn about its class imple- 
mentations. 

Implementations consist of two class hierarchies that mirror the two 
interface hierarchies. The root class in the collections hierarchy is 
AbstractCollection. That class specifies a skeletal implementation of 
the Collection interface. Similarly, the AbstractMap class serves as the 
root class in the mappings hierarchy. That class specifies a skeletal imple- 
mentation of the Map interface. The class library includes both classes to 
minimize the effort needed to implement the respective Collection and 
Map interfaces. 

NOTE 

All Collections API classes are located in the java.util package, and those classes 
that start with Abstract are abstract classes. 



Implementing Sets and Sorted Sets 

The class library provides an AbstractSet class (derived from 
AbstractCollection) that specifies a skeletal implementation of the Set 
interface. The class library also provides HashSet and TreeSet classes that 
are derived from AbstractSet. Objects created from the HashSet or TreeSet 
classes can be assigned to Set variables, but only objects created from 
TreeSet can be assigned to SortedSet variables. What is the difference 
between those classes? HashSets are faster than TreeSets. However, unlike 
TreeSets, HashSets are not ordered. Therefore, you will typically use a 
HashSet with a set and a TreeSet with a sorted set. 
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NOTE 

If HashSet and TreeSet do not meet your needs, you can derive a new class from 
AbstractSet. You then assign references to objects created from tlnat new class to 
Set variables. If the class also implements SortedSet, you can assign objects created 
from that class to SortedSet variables. 



^ \ I / 

EXAMPLE 



The SetDemo application in Listing 13.14 demonstrates use of HashSet, 
TreeSet, Set, and SortedSet. 

Listing 13.14: SetDemo. java. 
// SetDemo. java 



import java.util.*; 

class SetDemo 
{ 

public static void main (String [] args) 
{ 

String [] computerManuf acturers = 
{ 

"Toshiba" , 
"Gateway" , 
"Dell", 
"IBM" , 
"Compaq" 

}; 

Set s = new HashSet ( ) ; 

for (int i = 0; i < computerManufacturers. length; i++) 
s.add (computerManufacturers [i]); 

if (Is.add (computerManufacturers [0])) 

System. out. println ("Cannot add a duplicate. \n") ; 

Iterator iter = s. iterator (); 
while (iter.hasNext ()) 

System. out. println (iter. next ()); 



System. out. println (""); 
SortedSet ss = new TreeSet (); 



for (int i = 0; i < computerManufacturers. length; i++) 
ss.add (computerManufacturers [i]); 
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Listing 13.14: continued 

if (Iss.add (computerManuf acturers [0])) 

System. out. println ("Cannot add a duplicate. \n" ) ; 



iter = ss. iterator () ; 
while (iter.hasNext ()) 

System. out. println (iter. next ()); 

} 

} 

Set Demo's use of interfaces results in clean code that is easy to maintain. For 
example, if you replace Set s = new HashSet ( ) ; with Set s = new TreeSet 
( ) ; , you get the benefits of ordering a set without having to change any 
other program code. 



TIP 

Assign references to objects, which were created from Collections API classes, to API 
interface variables. Resulting code is easier to maintain. For example: Set s = new 
HashSet ();. 



OUTPUT 



When you run SetDemo, you will see the following output, which proves you 
cannot place object duplicates in either a set or a sorted set: 
Cannot add a duplicate. 

Compaq 

Toshiba 

IBM 

Gateway 
Dell 



Cannot add a duplicate. 



Compaq 
Dell 
Gateway 
IBM 

Toshiba 

Version 1.4 of the Java 2 Standard Edition SDK introduces LinkedHashSet 
(in the java.util package) as a subclass of HashSet. The LinkedHashSet class 
maintains objects in an internal doubly-linked list. That doubly-linked list 
allows LinkedHashSet to ensure a predictable iteration order based on the 
insertion order of objects. In contrast, HashSet does not define a predictable 
iteration order. In a sense, LinkedHashSet achieves the benefits of a TreeSet 
without incurring TreeSet's overhead. 
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Implementing Lists 

The class library provides an AbstractList class (derived from 
AbstnactCollection) that specifies a skeletal implementation of the List 
interface. The class library also provides AbstractSequentialList (and its 
LinkedList subclass) and ArrayList classes that are derived from 
AbstractList. Objects created from LinkedList or ArrayList classes can be 
assigned to List variables. What is the difference between those classes? 
LinkedLists are faster for insertion and deletion operations than ArrayLists. 
However, ArrayLists offer faster access to contained objects than 
LinkedLists. 

NOTE 

If LinkedList and ArrayList do not meet your needs, you can derive new classes 
from AbstractSequentialList and AbstractList, respectively. You then assign refer- 
ences to objects created from those new classes to List variables. 




EXAMPLE 



To learn more about LinkedList, ArrayList, and List, check out the ListDemo 
application in Listing 13.15. 

Listing 13.15: ListDemo. java. 
// ListDemo. java 



import java.util.*; 

class ListDemo 
{ 

final static int MAXOBJECTS = 5000; 
final static int MAXITERS = 70000; 

public static void main (String [] args) 
{ 

long [] times = new long [4]; 
List 1; 

for (int pass = 0; pass < 2; pass++) 
{ 

// Create list. 



if (pass == 0) 

1 = new ArrayList { ) ; 

else 

1 = new LinkedList { ) ; 
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Listing 13.15: continued 

// Populate list. 



for (int i = 0; i < MAXOBJECTS; i++) 
l.add ("A" + i); 

// Record start time. 

tines [pass * 2] = System. currentTineMillis (); 

// Update objects at randomly-selected indexes. 

for (int i = 0; i < MAXITERS; i++) 
{ 

int index = (int) (Math. random () * MAXOBJECTS); 
l.set (index, l.get (index)); 

} 

// Record end time. 

times [pass * 2 + 1] = System. currentTimeMillis (); 



} 



System. out. println ("ArrayList time = " + (times [1] - times [0])); 
System. out. println ("LinkedList time = " + (times [3] - times [2])); 



} 

} 



ListDemo compares the access performance of ArrayList and LinkedList. To 
measure that performance, ListDemo calls System's currentTimeMillis ( ) 
method, which returns the current time as the number of milliseconds that 
have elapsed since January 1, 1970. That method is called before and after 
a loop that updates a list's objects at randomly selected indexes. Because a 
LinkedList must sequentially search its nodes for the correct node, and 
because an ArrayList instantly returns an object when given an index, it 
comes as no surprise that the program reports a higher amount of elapsed 
time when tested against LinkedList. 

TIP 

If you want to remove a selected range of objects from a list, call List's subList ( ) 
method. For example, 1. subList (2, 4). clear (); removes "A2" and "A3" from 
ListDemo's list. 
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EXAMPLE 



Implementing Maps and Sorted Maps 

The class library provides HashMap, TreeMap, and WeakHashMap classes that 
are derived from AbstractMap. Objects created from HashMap, TreeMap, or 
WeakHashMap classes can be assigned to Map variables, but only objects cre- 
ated from TreeMap can be assigned to SortedMap variables. What is the differ- 
ence between those classes? As with sets, HashMaps are faster than TreeMaps. 
However, unlike TreeMaps, HashMaps are not ordered. Therefore, you will typi- 
cally use a HashMap with a map and a TreeMap with a sorted map. Finally, 
WeakHashMap is similar to HashMap except for WeakHashMap's use of weak refer- 
ences for keys. Use WeakHashMap when you are interested in a map as long as 
some other part of the program is also interested — expressed through the 
use of references to the same object. 

NOTE 

If HashMap, TreeMap, and WeakHashMap do not meet your needs, you can derive a new 
class from AbstractMap. You then assign references to objects created from that new 
class to Map variables. If the class also implements SortedMap, you can assign objects 
created from that class to SortedMap variables. 

\ I / You can learn more about HashMap, TreeMap, and Map by checking out the 
\k]\ MapDemo application in Listing 13.16. 

Listing 13.16: MapDemo. java. 
// MapDemo. java 

import java.util.*; 

class Employee 
{ 

private String name; 
private double salary; 

Employee (String name, double salary) 
{ 

this. name = name; 
this. salary = salary; 

} 

String getNane () 
{ 

return name; 

} 



double getSalary () 
{ 
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Listing 13.16: continued 
return salary; 

} 

} 

class MapDertio 
{ 

public static void main (String [] args) 
{ 

Map n = new HashMap ( ) ; 

Employee e = new Employee {"John Doe", 50000.0); 
m.put ("123-45-6789", e); 

e = new Employee ("Jim Smith", 30000.0); 
m.put ("999-99-9999", e); 

e = new Employee ("Jane Smith", 49750.0); 
m.put ("999-99-9999", e); 

Set entries = m.entrySet {); 

Iterator iter = entries . iterator (); 

while (iter.hasNext ()) 

{ 

Map. Entry me = (Map. Entry) iter. next (); 
System. out. print (me.getKey () + " "); 

e = (Employee) me.getValue (); 

System. out. println (e.getName () + " " + e.getSalary ()); 

} 

System. out. println ("Map size = " + m.size ()); 
System. out. println ("Empty: " + m.isEmpty ()); 

m. clear (); 

System. out. println ("Map size = " + m.size ()); 
System. out. println ("Empty: " + m.isEmpty ()); 

} 

} 

Because wlapDemo uses a HashMap implementation, it does not output a map's 
entries in order. To see those entries in order, replace Map m = new HashMap 
0; with Map m = new TreeMap ();. 
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TIP 

You might be confused as to when you use Map and when you use SortedMap as vari- 
able types, when writing source code. For maximum flexibility, in which you want to 
choose between any ordered and unordered Map implementation, use Map. If you use 
Map, you can assign a HashMap object reference, a TreeMap object reference, a 
WeakHashMap object reference, or a reference to any object created from a class that 
implements the Map interface, to a Map variable. However, if you are interested only in 
ordered implementations, use SortedMap. If you use SortedMap, you can assign only a 
TreeMap object reference, or a reference to any object created from a class that imple- 
ments the SortedMap interface, to a SortedMap variable. (The discussion also applies 
to when you use Set and when you use SortedSet.) 



When you run MapDemo, you will see the following output: 

999-99-9999 Jane Smith 49750.0 
123-45-6789 John Doe 50000.0 
Map size = 2 

Empty: false 

OUTPUT yap size = 0 

Empty: true 



1.4 



Version 1.4 of the Java 2 Standard Edition SDK introduces LinkedHashMap 
(in the java.util package) as a subclass of HashMap. The LinkedHashMap class 
maintains objects in an internal doubly-linked list. That doubly-linked list 
allows LinkedHashMap to ensure a predictable iteration order based on the 
insertion order of objects. In contrast, HashMap does not define a predictable 
iteration order. In a sense, LinkedHashMap achieves the benefits of a TreeMap 
without incurring TreeMap's overhead. 



Utilities 

Along with interfaces and classes, the Collections API includes a class of 
utilities. That Collections class (located in the java.util package) consists 
of several class methods that operate on or return collections and perform 
other tasks. Additionally, Collections provides some fields, which we will 
now examine. 



NOTE 

This section explores most of Collections' methods. To learn about methods not 
explored, please consult the SDK documentation. 



Empty Collections 

The Collections class declares three field variables: empty_list, empty map, 
and empty_set. Those fields represent empty and immutable (nonmodifiable) 
implementations of the List, Map, and Set interfaces, respectively. When a 
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EXAMPLE 




EXAMPLE 



method must return an empty list, map, or set, it can avoid the overhead of 
creating that container object by returning the appropriate field variable. 

The following code fragment returns an EMPTY LIST and checks its size: 
public static void main (String [] args) 
{ 

List 1 = readEmployees ("employee.dat"); 
System. out. println ("Num employees = " + l.size ()); 

} 

static List readEmployees (String filename) 
{ 

List 1; 
// Open file. 

// If file is empty, return EMPTY_LIST. 
return Collections. EMPTY_LIST; 

// Otherwise, create a List and fill it with Employee objects, 
// where each Employee object contains Employee information 
// stored in each row of the file. When finished, return the 
// List's reference. 
} 

Copying and Filling 

Collections declares the copy () and f ill( ) methods for copying and filling 
lists. Those methods have the following signatures: 
void copy(List dst, List src) 
void fill(List list. Object o) 

The copy ( ) method copies all objects from the src list to the dst list. When 
the copy completes, the index of each copied object in the dst list is the 
same as the index of each object in the src list. If the dst list is larger than 
the src list, remaining objects in the dst list are not affected by the copy. In 
contrast to copyO, the fill() method replaces all objects in list with the 
object referenced by o. 

The utilDemol source code in Listing 13.17 demonstrates the copy( ) and 
fillO methods. 

Listing 13.17: UtilDemol .java. 
// UtilDemol . java 



import java.util.*; 
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Listing 13.17: continued 
class UtilDenol 
{ 

public static void main (String [] args) 
{ 

String [] coins = 
{ 

"penny" , 
"nickel" , 
"dime" , 
"quarter" , 
"dollar" 

}; 

List src = new LinkedList {); 
for (int i = 0; i < coins . length; i++) 
src. add (coins [i]); 

// Create a second list that is as long as the first list. 

List dst = new ArrayList (); 
for (int i = 0; i < coins . length; i++) 
dst. add (""); 

// Copy src list's objects to dst list. 

Collections . copy (dst, src); 

// Iterate over the dst list's objects. 

Listlterator liter = dst . listlterator (); 

while ( liter. hasNext ()) 

System. out. println (liter. next ()); 

System. out. println (""); 

// Fill the src list with instances of "no coins." 
Collections. fill (src, "no coins"); 
// Iterate over the src list's objects, 
liter = src. listlterator (); 
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Listing 13.17: continued 

while (liter. hasNext ()) 

System. out. println (liter. next ()); 

} 

} 

UtilDemol produces the following output: 



penny 
nickel 
dime 

quarter 

OUTPUT dollar 

no coins 
no coins 
no coins 
no coins 
no coins 



CAUTION 

When performing a copy, the destination list must be as large as the source list. If the 
destination list is smaller, copy() throws an IndexOutOf BoundsException object. 
Also, copy( ) and f ill( ) throw UnsupportedOperationException objects if the list is 
immutable. 

■ " -4 Version 1.4 of the Java 2 Standard Edition SDK introduces a Collections 
^ _4 method for replacing all objects in a List with another object whose con- 
tents match the contents of the former objects. That method has the follow- 
ing signature: 

boolean replaceAll(List list, Object oldValue, Object newValue) 

When called, replaceAll( List list. Object oldValue, Object newValue) 
checks OldValue. If oldValue contains null, the method scans all list entries 
and, for each null entry, sets the entry to the object referenced by newValue. 
However, if oldValue does not contain null, the method scans all list entries 
and, for each entry whose object contents match oldValue's contents, sets 
the entry to the object referenced by newValue. If any list entry changes, 
replaceAll(List list, Object oldValue, Object newValue) returns true. 
Otherwise, it returns false. However, an UnsupportedOperationException 
object is thrown if the list is immutable. 

The following code fragment demonstrates the use of replaceAll(List list, 
Object OldValue, Object newValue) to replace all null entries in a List with 
references to a "Default" String object: 
EXAMPLE String [] names = 
{ 
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null, 

"Paula Dirksen" , 
"John Doe" , 
null, 

"Mary Smith" , 
"Jack Jones" 



List 1 = new ArrayList (); 



for (int i = 0; i < names. length; i++) 
l.add (names [i]); 



OUTPUT 



// Change all null entries to "Default." 

Collections . replaceAll (1, null, "Default"); 

// Iterate over the list's objects. 

Listlterator liter = l.listlterator (); 

while (liter. hasNext ()) 

System. out. println (liter. next ()); 

The preceding code fragment produces the following output: 

Default 
Paula Dirksen 
John Doe 
Default 
Mary Smith 
Jack Jones 



Enumerations 

Collections declares the enumeration ( ) method for providing interoperability 
with legacy APIs. That method has the following signature: 

Enumeration enumeration(Collection c) 

Given c's reference to an object whose class implements the Collection 
interface, enumeration ( ) returns a reference to an object whose class imple- 
ments the Enumeration interface. 

\ I / The following code fragment demonstrates obtaining an enumeration for a 
^1 set and using that enumeration to display all objects in the set: 
Set s = new HashSet (); 

EXAMPLE 




// Place objects in the set. 
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Enumeration e = Collections. enumeration (s); 
while (e . hasMoreElements ()) 

System. out. println (e.nextElement ()); 

■ - -4 Version 1.4 of the Java 2 Standard Edition SDK introduces a Collections 
^ 4 method that returns a List containing the elements returned by the 
Enumeration referenced by e, in the order they are returned by that 
Enumeration. That method has the following signature: 

List list(Enumeration e) 

The list(Enumeration e) method complements the enumeration(Collection 
c) method for providing interoperability with legacy APIs. 



\ I / The following code fragment demonstrates the use of list (Enumeration e) to 
return a List of a Vector's Enumeration: 

// Create a Vector object and populate that object with various 



EXAMPLE // objects. 

Vector V = new Vector (); 

v.add (new Integer (27) ) ; 
v.add ("Demo"); 

Stack s = new Stack ( ) ; 
s.push ("First"); 
s.push ("Second"); 

v.add (s); 

// Convert the Vector's Enumeration to a List. 

List 1 = Collections. list (v. elements ()); 

// Iterate over the list's objects. 

Listlterator liter = l.listlterator (); 

while (liter. hasNext ()) 

System. out. println (liter. next ()); 

The preceding code fragment produces the following output: 

27 

Demo 

[First, Second] 



OUTPUT 
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Maximum and Minimum 

To help developers obtain the largest and smallest objects in a collection, 
Collections provides the overloaded max() and min() methods. Those meth- 
ods have the following signatures: 
Object max(Collection c) 
Object max(Collection c, Comparator cmp) 
Object min(Collection c) 
Object min(Collection c, Comparator cmp) 

Given c's reference to an object whose class implements the Collection 
interface, the max ( ) methods return the maximum (largest) object in the col- 
lection, according to its natural order, and return the maximum object in 
the collection, according to its Comparator order (as referenced by cmp). 
Similarly, the min ( ) methods return the minimum (smallest) object in the 
collection, according to its natural order, and return the minimum object in 
the collection, according to its Comparator order (as referenced by cmp). As it 
is now the second time the natural and comparator order concepts have 
been mentioned, we should examine both concepts before investigating a 
program that demonstrates max ( ) and min ( ) . 

Objects are said to have natural order if their classes implement the 
Comparable interface. A close look at the Comparable interface shows us a sin- 
gle method: compareTo(). That method takes a single Object argument and 
compares it to the object that called the method. The compareTo() method 
returns a negative integer if the current object is smaller than the object 
referenced by the Object argument, a positive integer if the current object is 
larger, or zero if both objects have identical contents. Several of the class 
library's classes implement Comparable — String, Date, File, and Integer come 
to mind. The ordering produced by Comparable is said to be natural because 
it is the order naturally determined by a class's internal implementation of 
that interface. 

Objects are said to have comparator order if their classes implement the 
Comparator interface. That interface presents two methods: compare () and 
equals (). Although the compare () method returns the same information as 
compareToO, it takes two Object arguments and performs a comparison 
between those arguments, instead of comparing a single Object argument 
with the current object. You use a comparator when you want to order 
objects in a manner that differs from their natural order. For example, the 
String class's natural order is case sensitive. However, you can order String 
objects in a case-insensitive order by using the Comparator identified by 
String's CASE_INSENSITIVE_ORDER field. 
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EXAMPLE 



The utilDemo2 source code in Listing 13.18 demonstrates the max( ) and 
min ( ) methods, along with natural and comparator orders. 

Listing 13.18: UtilDemo2.]ava. 
// UtilDeno2. Java 



import java.util.*; 

class UtilDeno2 
{ 

public static void main (String [] args) 
{ 

String [] coins = 
{ 

"Penny" , 
"nickel" , 
"dime" , 
"Quarter" , 
"dollar" 

}; 

Set set = new TreeSet () ; 
for (int i = 0; i < coins . length; i++) 
set. add (coins [i]); 

System. out. println (Collections. min (set)); 
System. out. println (Collections. min (set, 

String. CASE_INSENSITIVE_ORDER) ) ; 

System. out. println (""); 

System. out. println (Collections. max (set)); 
System. out. println (Collections. max (set, 

String. CASE_INSENSITIVE_ORDER) ) ; 



5^ 



OUTPUT 



} 

UtilDemo2 produces the following output: 

Penny 
dime 



nickel 
Quarter 
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CAUTION 

If a collection contains objects that cannot be compared to each other, the max{ ) and 
min{) methods throw ClassCastException objects. Furthermore, if the collection is 
empty, the max() and min{) methods throw NoSuchElementException objects. 




EXAMPLE 



Reversal 

If you ever have a need to reverse a list, you should investigate Collections' 
rever'se( ) method. That method has the following signature: 
void reverse(List list) 

The reverse 0 method takes a list argument that references an object 
whose class implements List, and reverses the order of that list. 

The utilDemo3 source code in Listing 13.19 demonstrates the reverse() 
method. 

Listing 13.19: UtilDemo3. java. 
// UtilDemoS. java 



import java.util.*; 



class UtilDeno3 
{ 

public static void main (String [] args) 
{ 

String [] coins = 
{ 

"penny" , 
"nickel" , 
"dime" , 
"quarter" , 
"dollar" 

}; 

List 1 = new ArrayList (); 
for (int i = 0; i < coins. length; i++) 
l.add (coins [i]); 

// Iterate over the list's objects. 

Listlterator liter = l.listlterator (); 

while (liter. hasNext ()) 

System. out. println (liter. next ()); 



16 71710_CH13 11/21/01 4:29 PM Page 562 




562 Chapter 13: From Fundamental Data Structures to Collections 



Listing 13.19: continued 

System. out. println (""); 

// Reverse the list. 

Collections. reverse (1); 

// Iterate over the list's objects. 

liter = l.listlterator (); 

while (liter. hasNext ()) 

System. out. println (liter. next ()); 

} 

} 

UtilDemo3 produces the following output: 



penny 
nickel 
dime 

quarter 

OUTPUT doiia, 

dollar 

quarter 

dime 

nickel 

penny 



CAUTION 

If a list is immutable, reverse () throws an UnsupportedOperationException object. 



Singleton and Multiple Copy Collections 

If you find yourself needing an immutable set, list, or map that consists of a 

single object; call Collections' singleton methods. Those methods have the 

following signatures: 

Set singleton(Object o) 

List singletonList(Object o) 

Map singletonMap(Object key, Object value) 

The singleton () and singletonList() methods create sets and lists consist- 
ing of the single object referenced by o, whereas singletonMap( ) creates a 
map consisting of the single map entry that contains key and value. 
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EXAMPLE 




The following code fragment creates a singleton list consisting of a single 
Integer object: 

List 1 = Collections. singletonList (new Integer (0)); 

If an immutable list containing a single object does not satisfy your needs, 
you can create an immutable list containing multiple copies of the same 
object. That task is accomplished with the nCopies( ) method, which has the 
following signature: 
List nCopies(int n, Object o) 

The nCopies ( ) method creates a list consisting of n copies of a reference to 
the object referenced by o. The value passed in n should not be negative, or 
nCopiesO will throw an IllegalArgumentException object. 

The following code fragment creates a list consisting of 10 copies of the null 
reference: 



^1 List 1 = Collections. nCcpies (10, null); 



EXAMPLE 



TIP 

Because nCopies( ) returns an immutable list, you might wonder about tliat metlnod's 
usefulness. Keep in mind that you can pass the result to the copy constructor of an 
ArrayList or LinkedList, and the resulting list is mutable. For example: List 1 = 
new ArrayList (Collections . nCopies (10, null) );. That works because collec- 
tions classes (such as LinkedList and ArrayList) are required to have at least one 
constructor (known as a copy constructor) that takes a Collection argument. The 
result is: You can construct an implementation object (such as an ArrayList object) 
that contains a copy of each object that is also stored in a different collection — in a 
single step. 



Sorting and Searching 

Sets and maps have the capability of being sorted (that is, ordered). Sorting 

is automatically handled by classes, such as SortedSet and SortedMap. No 

such capability exists for lists, however. To deal with that situation. 

Collections offers a pair of sort() methods that are tailored for lists. Those 

methods have the following signatures: 

void sort(List list) 

void sort(List list, Comparator cnp) 

The first sort( ) method sorts the list, referenced by list, using that list's 
natural order. In contrast, the second sort() method sorts list in compara- 
tor order, by using the Comparator object referenced by crrp. 

\ I / The utilDemo4 source code in Listing 13.20 demonstrates the use of both 
^1 sort ( ) methods to sort an array of Employee objects in natural order (based 
on employee names) and comparator order (based on employee salaries). 



EXAMPLE 
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Listing 13.20: UtilDemo4. java. 
// UtilDeno4. java 

import java.util.*; 

class Employee implements Comparable 
{ 

private String name; 
private double salary; 

Employee (String name, double salary) 

this. name = name; 
this. salary = salary; 

String getName () 
return name; 

ouble getSalary () 
return salary; 

public String toString () 

return "Name = " + getName {) + ", Salary = " + getSalary (); 

/ Natural order consists of names in AZ order. 

public int compareTo (Object o) 

// If 0 does not represent either an Employee class or 
// one of its subclasses, throw a ClassCastException 
// object. 

if ( ! (0 instanceof Employee)) 

throw new ClassCastException (); 

Employee e = (Employee) o; 



return name. compareTo (e. getName ()); 

} 
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Listing 13.20: continued 

// Comparator order consists of salaries. 

static class SalaryComparator implements Comparator 
{ 

public int compare (Object o1 , Object o2) 
{ 

if (!(o1 instanceof Employee) || !(o2 instanceof Employee)) 
throw new ClassCastException (); 

Employee e1 = (Employee) o1 ; 
Employee e2 = (Employee) o2; 

return (int) (e1 .getSalary () - e2.getSalary ()); 

} 

} 

} 

class UtilDemo4 
{ 

public static void main (String [] args) 
{ 

String [] names = 
{ 

"Paula Dirksen" , 
"John Doe", 
"Mary Smith", 
"Jack Jones" 

}; 



double [] salaries = 
{ 

28500.0, 
75000.0, 
56000.0, 
48000.0 

}; 



List 1 = new ArrayList (); 



for (int i = 0; i < names . length; i++) 

l.add (new Employee (names [i], salaries [i])); 



Collections. sort (1); 



// Iterate over the list's objects. 
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OUTPUT 



Listing 13.20: continued 

Listlterator liter = l.listlterator (); 

while (liter. hasNext ()) 

System. out. println (liter. next ()); 

System. out. println (""); 

Collections . sort (1, new Employee. SalaryComparator ()); 

// Iterate over the list's objects. 

liter = l.listlterator (); 

while (liter. hasNext ()) 

System. out. println (liter. next ()); 

} 

} 

UtilDemo4 produces the following output: 

Name = Jack Jones, Salary = 48000.0 

Name = John Doe, Salary = 75000.0 

Name = Mary Smith, Salary = 56000.0 

Name = Paula Dirksen, Salary = 28500.0 



Name = Paula Dirksen, Salary = 28500.0 

Name = Jack Jones, Salary = 48000.0 

Name = Mary Smith, Salary = 56000.0 

Name = John Doe, Salary = 75000.0 



CAUTION 

If a list is immutable, the sort ( ) methods throw UnsupportedOperationException 
objects. 



Version 1.4 of the Java 2 Standard Edition SDK introduces a Collections 
method for swapping list elements. That method has the following 
signature: 

void swap(List list, int i, int j) 

When called, swap (List list, int i, int j ) swaps the objects at positions i 
and j in the list referenced by list. If either i or j contains a value that is 
less than 0 or greater than list. sizeO -1, swap (List list, int i, int j) 
throws an indexOutOf BoundsException object. Otherwise, the objects at those 
positions are swapped. 
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Why was swap (List list, int i, int j ) added to the Collections class? 
According to the SDK 1.4 documentation, that method offers fast perfor- 
mance. As a result, if you ever need a fast way to swap objects (such as 
when performing a sort operation), call that method. 

The following code fragment demonstrates the use of swap (List list, int 
i, int ] ) to swap the first and third entries in a list built from an array of 
Strings: 
EXAMPLE String [] names = 
{ 

"Paula Dirksen", 
"John Doe" , 
"Mary Smith" , 
"Jack Jones" 

}; 

List 1 = new ArrayList (); 

for (int i = 0; i < names. length; i++) 
l.add (names [i]); 

// Swap Paula Dirksen with Mary Smith. 

Collections. swap (1, 0, 2); 

// Iterate over the list's objects. 

Listlterator liter = l.listlterator (); 

while (liter. hasNext ()) 

System. out. println (liter. next ()); 



OUTPUT 



The preceding code fragment produces the following output: 

Mary Smith 
John Doe 
Paula Dirksen 
Jack Jones 

Earlier in this chapter, you learned about the binary search. That tech- 
nique is the fastest known way of finding information stored in a sorted 
list. To save you the trouble of devising your own binary search code for an 
arbitrary List, Collections declares a pair of overloaded binarySearch( ) 
methods. Those methods have the following signatures: 
int binarySearch(List list, Object item) 
int binarySearch(List list. Object item. Comparator cmp) 
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Each method takes a list argument that identifies the hst to be searched. 
Each method also takes an item argument that identifies what must be 
found. The first binarySearch( ) method performs its search using natural 
order, whereas the second binarySearch( ) method takes a cmp argument that 
identifies the Comparator for use in a search based on comparator order. If 
item is found in the list, its index returns. Otherwise, a negative integer 
returns. 

CAUTION 

If a list contains objects that are not mutually comparable — such as Integer and 
String objects — (unless a comparator is specified to perform an appropriate compari- 
son) or if the search item is not mutually comparable with the objects of the list 
(unless an appropriate comparator is specified), the binarySearch( ) methods throw 
ClassCastException objects. 

■ ■ -4 Version 1.4 of the Java 2 Standard Edition SDK introduces a pair of 
^ 4 Collections methods that search a list for the first and last occurrence or a 

sublist. Those methods have the following signatures: 

int indexOfSubList (List source, List sublist) 

int lastlndexOf SubList (List source, List sublist) 

When called, indexOfSubList (List source, List sublist) searches source for 
the first occurrence of sublist. If sublist is found, the index of the first 
sublist object relative to source returns. Otherwise, -1 returns. Similarly, 
when called, lastlndexOf SubList (List source, List sublist) searches source 
for the last occurrence of sublist. If subList is found, the index of the first 
sublist object relative to source returns. Otherwise, -1 returns. Both meth- 
ods are commonly used in text processing situations. 

The following code fragment demonstrates the use of indexOfSubList (List 
source, List sublist) and lastIndexOfSubList(List source, List sublist) 
to search for the first and last occurrences of a sublist: 




EXAMPLE // Build list of favorite flavors. 

String [] f avoriteFlavors = 
{ 

"apple" , 
"cherry" , 
"banana" , 
"grape" , 
"strawberry" , 
"raspberry" , 
"cherry" , 
"banana" , 
"watermelon" 
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}; 

List 1 = new ArrayList (); 

for (int i = 0; i < favoriteFlavors. length; i++) 
l.add (favoriteFlavors [i]); 

// Build first sublist. 

List sublist = new ArrayList (); 

sublist. add ("cherry"); 
sublist. add ("banana"); 

// Print index of first occurrence of first sublist. 

System. out. println (Collections . indexOfSubList (1, sublist)); 

// Print index of last occurrence of first sublist. 

System. out. println (Collections . lastlndexOfSubList (1, sublist)); 

// Build second sublist. 

sublist = new ArrayList (); 

sublist. add ("Cherry"); 
sublist. add ("banana"); 

// Print index of first occurrence of second sublist. 

System. out. println (Collections . indexOfSubList (1, sublist)); 

The preceding code fragment produces the following output, which proves 
the search is case sensitive: 



Synchronized Collections 

Unlike their legacy counterparts, Collections API objects are not thread- 
safe. If you require a thread-safe collection, simply call one of the following 
S3nichronized methods: 

Collection synchronizedCollection(Collection c) 
List synchronizedList (List 1) 




OUTPUT 
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EXAMPLE 



Map synchronizedMap(Map m) 

Set synchronizedSetlSet s) 

SortedMap synchronizedSortedMap{SortedMap sm) 

SortedSet synchronizedSortedSet{SortedSet ss) 

To use synchronized collections correctly, all access to a collection must be 
done through the synchronized wrapper that each method returns. Also, 
whenever you iterate through a synchronized collection, you must manually 
synchronize iteration code in a synchronized block. 

The following code fragment demonstrates obtaining a synchronized list 
and iterating over that list in a synchronized block: 
List 1 = Collections. synchronizedList (new ArrayList ()); 

// ... 

synchronized (1) 
{ 

Iterator i = 1. iterator!) ; // Must be in the synchronized block. 

while (i.hasNext ()) 

doSomething (i.next ()); 

} 

Unmodifiable Collections 

By default, a collection object can be modified. If you ever need an 

immutable collection, call one of the following unmodifiable methods: 

Collection unnodif iableCollection(Collection c) 

List unmodif iableList (List 1) 

Map unmodif iableMap (Map m) 

Set unmodif iableSet (Set s) 

SortedMap unnodif iableSortedMap(SortedMap sm) 

SortedSet unnodif iableSortedSet(SortedSet ss) 

Any attempt to modify an unmodifiable collection, either directly or via its 
iterator, results in an UnSupportedOperationException object being thrown. 



What's Next? 



This chapter introduced two applications that used the sqrt ( ) and random () 
methods of the Math class. To learn more about Math and Java's support for 
mathematics, turn to the next chapter. 
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Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 

NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers," at the end of the book. 




REVIEW 



Reviewing it 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. What are three benefits to a collections framework? 

2. Why are Hashtable, Stack, and Vector methods synchronized? 

3. What is one circumstance in which an UnsupportedOperationException 
object would be thrown? 

4. What are two main differences between a Properties object and a 
Hashtable object? 

5. Unlike SortedMap and SortedSet, the Collections API does not include a 
SortedList interface. Apart from oversight, can you think of a reason 
why SortedList is not included? 



CHECK 



Clieci^ing it 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 



Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. Which interface is not in the same hierarchy? 

a. Set 



b. Collection 
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c. SortedMap 

d. List 

2. The Hashtable class has been integrated into the Collections API. As a 
result, which of the following interfaces does Hashtable implement? 

a. SortedMap 

b. Map 

c. SortedSet 

d. Set 

3. Which of the following wrapper classes provides a method that con- 
verts a number to a hexadecimal string? 

a. Integer 

b. Byte 

c. Short 

d. All of the above 

4. The technique of searching a hashtable's internal linked lists is known 
as what? 

a. The Sieve of Eratosthenes 

b. Bubble sort 

c. Linear search 

d. Linear probing 

5. Which data structure is used to model a checkout line in a grocery 
store simulation? 

a. Tree 

b. Hashtable 

c. Stack 

d. Queue 

6. Which of the following Collection interface methods is not designated 
to be optional? 

a. add() 

b. iteratorO 
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c. remove () 

d. cleanO 

7. Which of the following interfaces specifies the capability of adding 
objects to a collection during enumeration? 

a. Listlteraton 

b. Iterator 

c. Enumeration 

d. None of the above 

8. Collections' sort( ) methods are designed to sort what? 

a. Maps 

b. Sets 

c. Lists 

d. All of the above 

9. Which interface represents natural order? 

a. Comparable 

b. Enumeration 

c. Comparator 

d. Iterator 

10. Which of the following statements is true? 

a. Sets can contain object duplicates. 

b. Collections' singletonList ( ) method returns a reference to a List 
object containing one object. 

c. AbstractMap is the root class of both the collections and mappings 
implementation hierarchies. 

d. References to HashMap objects can be assigned to SortedMap 
variables. 
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True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. Arrays automatically expand with additional elements to accommo- 
date new data items. 

True/False 

2. Arrays are objects. 
True/False 

3. System. arraycopy ( ) is the fastest technique for copying one array to 
another. 

True/False 

4. Linear search is faster than binary search and requires arrays to be 
sorted. 

True/False 

5. Runtime's totalMemory ( ) and f reeMemory ( ) methods return the total and 
free sizes, respectively, of the underlying platform's memory. 

True/False 

6. Java supplies a void class that is more of a placeholder class than a 
wrapper class. 

True/False 

7. Arrays are faster than linked lists when it comes to insertion and 
deletion operations. 

True/False 

8. Unlike Hashtable and Vector, Collections API classes do not contain 
synchronized methods. 

True/False 

9. Collections' nCopies( ) method returns a mutable list that consists of 
multiple copies of some object. 

True/False 

10. Stack's peek( ) method returns a reference to the object at the top of a 
stack and removes that object from the stack. 

True/False 
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Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 



APPLY 

1. Although this chapter explored one-dimensional and two-dimensional 
arrays (tables), the three-dimensional array is also useful. Think of a 
three-dimensional array as an array of tables. For example, a movie is 
a three-dimensional array, and each element of that array is an 
image — a table of pixels. Suppose you are given a pair of tables, where 
the first table consists of three rows by two columns, and the second 
table consists of two rows by three columns, and each element con- 
tains an integer value, as follows: 

Table 1:12 
3 4 
5 6 

Table 2: 7 8 9 
1 2 3 

Declare an array variable named x that references a three-dimensional 
array. Initialize that array to the preceding values, without using key- 
word new. Then, write code fragments that return the number of tables 
(which is 2), the number of rows in the first table (which is 3), and the 
value stored in the second column of the first row of the second table 
(which is 8). (Array indexes begin at zero, so "first row" corresponds 
with row index 0.) 

2. Write a dunip( ) method consisting of nested For loop statements that 
prints out the contents of a three-dimensional array. Use the previous 
exercise's three-dimensional array to test your method. 

3. Write a code fragment that prints out the value of the os . name system 
property. 

4. Although the class library contains a Stack class, it does not contain a 
Queue class. Write a Queue class that, like Stack, extends Vector. Your 
Queue class will declare two methods: void insertAtTail (Object o) and 
Object removeFromHead(). Those methods must call appropriate Vector 
methods to add an object to the queue's tail and retrieve an object 
from the queue's head. After you complete writing Queue, write a 
QueueDemo application that demonstrates that class. The application 
should show that the first object inserted into the queue, by a call to 
insertAtTail 0, is the first object removed from the queue, by a call to 
removeProfTiHead ( ) . 
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5. Write a code fragment that demonstrates the use of a copy constructor 
to copy the contents of a set to a hst. 

6. Suppose you have an unsorted array of South American country 
names: Ecuador, Venezuela, Argentina, Brazil, and Chile. Write a 
Search application that creates a list from those country names, sorts 
those names, and searches (using Collections' binarySearch(List list, 
Object item) method) the sorted list for Venezuela. If the country 
name is found, the program should display Found along with the name 
of the search item, by using binarySearch( )'s returned index and List's 
get ( ) method. However, if the binary search cannot find Venezuela 
(which is indicated by binarySearch( ) returning a negative integer), it 
should display a Not found message. To see that binarySearch( ) 
requires a sorted list, make sure the country names are added to the 
list in the aforementioned order and comment out the call to 
Collections' sort 0 method. 
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Mathematics 

Computer languages are often judged on the basis of their support for vari- 
ous mathematical operations. That support determines a language's effec- 
tiveness in certain mathematics-intensive fields, like numerical analysis. 
This chapter explores Java's mathematics support, from basic concepts to 
classes. During that exploration, you'll see how well Java fares in its sup- 
port for mathematics. 
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Java and Mathematics 



Numeric types are the foundation of Java's mathematics support. A numeric 
type is either integer (a number with no fractional part) or floating-point (a 
number with a decimal point). This section explores numeric types, by 
focusing first on integer types and then on floating-point types. Also, when 
it comes to floating-point operations, several issues need to be addressed. 
This section also addresses those issues. 



Integer Types 

Java's integer types are byte, integer, long integer, and short integer. Each 
type defines a format that represents values of that type in memory. 
Because those types are signed types, each format is capable of storing pos- 
itive and negative values. Those types also identify those mathematics- 
based operators that can be legally applied to integer values. 



Internal Representation 

The integer types are similar in that they describe an internal representa- 
tion consisting of a sign bit and a magnitude (the value). However, they dif- 
fer in the number of bits assigned to the magnitude: a byte value's 
magnitude is stored in 7 bits, an integer value's magnitude is stored in 31 
bits; a long integer value's magnitude is stored in 63 bits, and a short inte- 
ger value's magnitude is stored in 15 bits. Figure 14.1 illustrates the four 
integer type formats. 



S M byte 



15 



31 



short 



int 



long 



63 



Legend: 

S -Sign bit 

M -Magnitude 

0 -Least significant bit 



Figure 14.1: Java's four integer type formats include byte, integer, long inte- 
ger, and short integer. 
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Java internally represents integer values in one of two ways. If the value is 
positive (including zero), the sign bit is set to zero and the value's bits are 
stored directly in the magnitude. However, if the value is negative, the sign 
bit is set to one, and the value's bits are stored in the magnitude, after flip- 
ping each bit from 1 to 0 and 0 to 1 — and adding one to the result. Figure 
14.2 shows the internal representations of positive and negative bytes 126 
and -126, respectively. 



126 



0 


1 


1 


1 


1 


1 


1 


0 



sign bit 



magnitude 
0 



-126 
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0 


0 


0 


0 


0 


1 


0 



Figure 14.2: Positive and negative byte representations of 126 and -126. 

To convert the magnitude of a positive integer from binary to decimal, each 
bit's value is multiplied by two (raised to the power of the bit's position, 
where the rightmost bit is located at position zero). The resulting values 
are then added together to produce the equivalent decimal value. Figure 
14.3 shows the conversion of a positive byte's magnitude from its binary 
representation to decimal. 



0 
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1 


1 


1 


1 


0 



1) Convert to decimal: 1 x 2^ + 1 x 2= + 1 x 2" + 1 x 2^ + 1 x 2^ + 1 x 2^ = 126 



0 2) Because sign bit is 0, interpret value as 126. 



Figure 14.3: The conversion of a positive byte's magnitude from binary to 
decimal. 



To convert the magnitude of a negative integer from binary to decimal, 
magnitude bits must be flipped, and one must be added to the result. That 
"flipping and adding one" activity is known as twos-complement. Figure 
14.4 shows the conversion of a negative byte's magnitude from its binary 
representation to decimal. 
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0 



1 ) Flip bits: 000001 0 becomes 1111101 



7 0 2) Add1:1111101 becomeslinno 

3) Convert to decimal: 1 x + 1 x 2^ + 1 x 2" + 1 x 2^ + 1 x 2^ + 1 x 2' = 126 

4) Because sign bit Is 1 , interpret value as -126. 

Figure 14.4: The conversion of a negative byte's magnitude from binary to 
decimal. 



TIP 

When assigning integer literals to variables, you can work at the internal representation 
level by using hexadecimal notation. For example, to assign -1 to x, you can specify 
int X = Oxffffffff;. 



Mathematics-Based Operators 

Java defines the following mathematics-based operators for values of inte- 
ger types: additive (+ or -), multiplicative (*, /, or %), shift (« or »), 
unary plus (+), negation ( -), preincrement/postincrement (++), and predecre- 
ment/postdecrement ( - - )■ There are two things to keep in mind when work- 
ing with those operators: overflow/underflow and what happens when an 
attempt is made to divide by zero. 

Overflow/underflow takes place when a mathematical operation occurs and 
there is insufficient room to hold the result. Either condition can be 
detected by a change of sign in the result. For example, if two positive inte- 
gers are added and the result is negative, an overflow has occurred. 

The following code fragment demonstrates overflow and underflow: 
short s = 32767; 

System. out. println (s); // Output: 32767 

EXAMPLE 

System. out. println (s); // Output: -32768 (Overflow) 

s--; 

System. out. println (s); // Output: 32767 (Underflow) 

Because the magnitude of a short integer is assigned 15 bits, the largest 
positive value that can be stored is 32767. Adding one to that value results 
in overflow. Similarly, the smallest negative value that can be stored is 
-32768. Subtracting one from that value results in underflow. 

CAUTION 

Avoid performing math operations on integer values that result in overflow or underflow. 
Java does not alert a program to either condition. 




17 71710_CH14 11/21/01 3:05 PM Page 583 




Java and Mathematics 583 



In addition to overflow and underflow, attempts to divide by zero are 
another kind of problem. However, Java alerts programs to division by zero 
attempts via ArithmeticException objects. When an attempt is made to 
divide by zero, either by using / or by using %, the JVM views that attempt 
as an exceptional situation, creates an ArithmeticException object that 
describes the division by zero attempt, and searches the program for a 
Catch clause that handles that type of exception. 

\ I / The following code fragment demonstrates two attempts to divide by zero, 

Hi "^y way of the / and % operators: 

f^i int X = 1 Id; 

EXAMPLE int y = 1 % 0; 



CAUTION 

Avoid division by zero attempts winen performing integer divisions witli eitlier / or %. Tine 
JVIVl raises an exception when the attempt is made. If the program does not handle 
that exception (and it shouldn't, because that kind of exception will never occur in a 
properly written program), the JVM terminates the program. 




Floating-Point Types 

Java's floating-point types consist of floating-point and double-precision 
floating-point. Each type defines a format, based on the IEEE 754 floating- 
point specification, that represents values of that type in memory. Those 
types also identify mathematics-based operators that can be legally applied 
to floating-point values. 



Internal Representation 

The floating-point types are similar in that they describe an internal repre- 
sentation consisting of a sign bit, an exponent, and a mantissa. The expo- 
nent determines the range of values that can be represented, and the 
mantissa determines the precision (number of significant digits). However, 
the types differ in the number of bits assigned to the exponent and man- 
tissa: a floating-point value's exponent is stored in 8 bits, and the mantissa 
is stored in 23 bits. That gives a floating-point value a range of approxi- 
mately ±1.18-1-10"^^ and ±3.40-1-10^* and a precision of between six and nine 
digits. In contrast, a double-precision floating-point value's exponent is 
stored in 11 bits, and the mantissa is stored in 52 bits. That gives a double- 
precision floating-point value a range of approximately ±2.23+10"^°* and 
±1.794-10^°^ and a precision of between 15 and 17 digits. Figure 14.5 illus- 
trates both floating-point type formats. 
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-Least significant bit 



Figure 14.5: Java's two floating-point type formats, as defined by the IEEE 
754 floating-point specification. 

According to the IEEE 754 specification, a floating-point value is stored in 
a normalized format. That means mantissa bits are shifted left (and the 
exponent incremented from a base value) until the most significant bit of 
the mantissa contains one. Because that bit is known to be one, it does not 
need to be stored — one more left shift, and exponent increment is per- 
formed to account for that "implied" bit. As a result, a floating-point tj^e 
value actually has its mantissa represented in 24 bits. Furthermore, in 
reality, a double-precision floating-point type value has its mantissa repre- 
sented in 53 bits. 

TIP 

You might have occasion to obtain the internal representation of either a floating-point 
value or a double-precision floating-point value. That task can be accomplished by call- 
ing Float's f loatToIntBits ( ) and Double's doubleToLongBits( ) methods, 
respectively. Conversely, call Float's intBitsToFloat ( ) method or Double's 
longBitsToDouble( ) method to either convert the contents of an integer to a floating- 
point value or the contents of a long integer to a double-precision floating-point value. 

Some floating-point values do not have an exact representation. For exam- 
ple, the result of dividing one by three results in a fraction with an infinite 
number of digits. Because computers have finite amounts of memory, there 
is no way that one divided by three can be stored exactly. That lack of preci- 
sion can result in logic problems where equality operators are used, in a 
loop context, to test for a stopping condition that involves floating-point 
values — as demonstrated by the following code fragment: 
double X = 1.0: 



while (x != 0.1) 
{ 
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System. out. println (x); 
X -= 0.1; 

} 

If you run the code fragment, you will find yourself facing an infinite loop. 
To see why, examine the following (partial) output: 
1 . 
0.9 
8 

7000000000000001 
6000000000000001 
5000000000000001 
4000000000000001 3 
3000000000000001 6 
2000000000000001 5 
10000000000000014 
1 .3877787807814457E-16 
-0.09999999999999987 
-0.19999999999999987 
-0.2999999999999999 
-0.3999999999999999 
-0.4999999999999999 

Because 0 . i cannot be represented exactly, small errors creep into the x - = 
0 . 1 calculation. Those errors do not become significant until an attempt is 
made to subtract 0.1 from 0.8. At that point, there is no way that x will 
ever equal 0.1. 

CAUTION 

Never use the equality operators with floating-point values in an expression that serves 
as the stopping condition for a loop. Because of the inexact representation of many 
floating-point values, odds are that you will end up with a loop that never ends. 



Mathematics-Based Operators 

Java defines the following mathematics-based operators for values of 
floating-point types: additive (-^ or -), multiplicative (*, /, or %), unary plus 
(-^), negation ( -), preincrement/postincrement (++), and predecrement/ 
postdecrement ( - - ). Those operators can be thought of as overloaded opera- 
tors because they handle floating-point operations in addition to integer 
operations. 

As with integer operations, overflow and underflow are still possible with 
floating-point operations, and programs are not alerted to those conditions. 
However, unlike their integer division counterparts, if you attempt to divide 
a floating-point value by zero, there are no exceptions. Instead, a result is 
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returned that represents a special value: +Infinity, -Infinity, or NaN (Not a 
Number). Those values are based on IEEE 754 specification rules. For 
example, if you divide a positive floating-point value by zero, -t-Infinity 
returns. Similarly, if you divide a negative floating-point value by zero, 
-Infinity returns. However, dividing zero by zero returns NaN. 

You can test for -nlnfinity or -Infinity by comparing a floating-point value 
with the P0SITIVE_INFINITY and negative_infinity constants, declared in the 
Float and Double classes. Which constant you test against depends on the 
type of the floating-point value: floating-point or double-precision floating- 
point. However, to test for NaN, you cannot use the NaN constants in Double 
and Float. Instead, you must call their isNaN( ) methods. 

The following code fragment demonstrates the proper way to test for 
H-Infinity, -Infinity, and NaN: 

float f = 1 .0f / 0.0f ; 
if (f == Float. POSITIVE_INFINITY) 
System. out .print In ( "+Infinity" ) ; 

f = -1.0f / 0.0f; 
if (f == Float. NEGATIVE_INFINITY) 
System. out . print In ( " -Infinity" ) ; 

f = 0.0f / 0.0f; 
if ( Float. isNaN ) 

System. out. println ("Not a number"); 

double d = 1.0 / 0.0; 
if (d Double. POSITIVE_INFINITY) 
System. out .println ( "+Inf inity" ) ; 

d = -1.0 / 0.0; 

if (d == Double. NEGATIVE_INFINITY) 
System. out . println ( " -Infinity" ) ; 

d = 0.0 / 0.0; 
if (Double. isNaN ) 

System. out. println ("Not a number"); 

TIP 

The IEEE 754 specification recognizes multiple NaN values for each of the floating-point 
and double-precision floating-point types. For each floating-point type, Java collapses all 
those NaN values into a single canonical value and always refers to that value (when 
dealing with NaN). However, it is possible to obtain the actual floating-point NaN value 
by calling Float's floatToRawIntBitsO method, and the actual double-precision 
floating-point NaN value by calling Double's doubleToRawLongBits( ) method. (In contrast, 
floatToIntBitsO and doubleToLongBitsO only return the canonical NaN values.) 
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Floating-Point Issues 

When it comes to floating-point mathematics, there are two issues to deal 
with. The first issue deals with extra accuracy versus portability and is the 
domain of value sets and FP-strictness. The second issue involves Java's 
failure to completely support the IEEE 754 specification, which leads to 
problems for numerical analysts, as you will see. 

Value Sets and FP-strict 

Implementations of the Java language must support two standard sets of 
floating-point values. Those sets are known as the float value set (corre- 
sponding to the floating-point type) and the double value set (corresponding 
to the double-precision floating-point type). Furthermore, an implementa- 
tion may support one or both of two extended-exponent value sets: the float 
extended-exponent value set and the double extended-exponent value set. 

Extended-exponent value sets offer the same range of precision as the stan- 
dard value sets, but offer a greater range of exponents. That extra exponent 
range can result in increased accuracy. For example, suppose a calculation 
involves the generation of one or more intermediate floating-point values. 
Furthermore, suppose all values are taken from a standard value set. Finally, 
suppose an intermediate value requires an exponent that lies outside the 
range of the standard value set's range of exponents. The result is an 
extremely inaccurate calculation. In contrast, suppose that the JVM uses val- 
ues from an extended-exponent value set. Now, if an intermediate value is 
generated, whose exponent lies outside the range of a standard value set's 
range of exponents, but lies inside the range of an extended-exponent's range 
of exponents, the calculation will be able to produce a more accurate result. 

At some point, values taken from extended-exponent value sets must be 
mapped back to values from the standard value sets. For example, a value 
from the float extended-exponent value set is mapped to the nearest value 
from the float value set, and a value from the double extended-exponent 
value set is mapped to the nearest value from the double value set. That 
mapping, which does not change the type of a floating-point value, is 
required so that final results fit into 32 bits (for floating-point values) or 64 
bits (for double-precision floating-point values) and is known as value set 
conversion. 



NOTE 

The extended-exponent value set formats are similar to the IEEE 754 specification for- 
mats for floating-point and double-precision floating-point values. However, the float 
extended-exponent value set format uses at least 11 bits to hold an exponent, whereas 
the float value set uses 8 bits. Furthermore, the double extended-exponent value set 
uses at least 15 bits, whereas the double value set uses 11 bits. 



17 71710_CH14 11/21/01 3:05 PM Page 588 




588 Chapter 14: Mathematics 




EXAMPLE 



Sun has designed Java so that floating-point expressions default to obtain- 
ing values from an extended-exponent value set (provided an implementa- 
tion allows that to happen). Those expressions are known as non-FP-strict 
expressions because they do not strictly obtain their values from standard 
value sets. In contrast, compile-time constant expressions and expressions 
that perform calculations in a context identified by the strictfp keyword 
are known as FP-strict expressions. Those expressions can only obtain 
floating-point values from the standard value sets. 

The strictfp keyword can be specified as part of a class declaration, an 
interface declaration, or a method declaration. When applied to a class dec- 
laration, every expression in every member declared in that class is FP- 
strict. However, when specified as part of a method declaration, only 
expressions in that method (and members of that method) are FP-strict. 

In the following code fragment, by declaring the Employee class with the 

strictfp keyword, all expressions in all future members of that class are 

FP-strict. Also, by declaring only circumference () in the CircleUtilities 

class with the strictfp ke3rword, only that method is FP-strict: 

strictfp class Employee 

{ 

} 

class CircleUtilities 
{ 

static strictfp double circumference (double diameter) 
{ 

return Math. PI * diameter; 

} 

} 

TIP 

Use the strictfp keyword to ensure that floating-point code is portable across plat- 
forms. However, if you need extra accuracy, offered by an increased range of exponents, 
on a single platform, dont use strictfp. 



Floating-Point Imperfections 

You might be surprised that Java's floating-point math support is far from 
perfect. Imperfections arise from Java not completely supporting the IEEE 
754 specification. Although many developers won't find those imperfections 
to be a problem, Java's floating-point imperfections are a concern to numer- 
ical analysts. This section briefly examines two imperfections: lack of sup- 
port for IEEE 754 specification arithmetic exceptions and lack of support 
for IEEE 754 specification directed rounding modes. 
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The IEEE 754 specification uses the term exception to refer to a floating- 
point operation that is invahd (such as dividing infinity by infinity), results 
in overflow, results in underflow, indicates a divide by zero attempt, or indi- 
cates an inexact result. (Do not confiise IEEE 754 specification's exception 
term with Java's exception term — the two terms are different.) In a lan- 
guage that completely supports the IEEE 754 specification, an internal flag 
(corresponding to one of the five exceptions already mentioned) is set when 
a floating-point operation resulting in that exception occurs. A program can 
subsequently test and clear that flag and make decisions based on overflow, 
underflow, and other conditions. However, Java does offer that capability. 

The IEEE 754 specification defines four rounding modes: round to nearest 
(which is what Java uses and means: given a floating-point value b that 
cannot be precisely represented, and two representable floating-point val- 
ues a and c, such that a < b < c, round to the closer of a or c), round down to 
-infinity, round up to -i-infinity, and round to zero. Those last three 
"directed" rounding modes are not supported by Java. That is unfortunate 
because numerical analysts often use directed rounding modes to discover 
the location of instabilities in unstable floating-point algorithms. 



NOTE 

For more information on Java's floating-point imperfections, read tine PDF document 
How Java's Floating-Point Hurts Everyone Everywiiere. That document, written by 
Professor W. Kalian and Joseph Darcy, is located at http://www.cs.berkeley.eclu/ 
-wkahan/JAVAhurt . pdf . 



Essential Math Classes 



Computer languages typically support advanced math operations (such as 
trigonometric sine, cosine, and tangent) by way of function libraries. Java is 
no different: You can find support for advanced math operations in the 
standard class library's Math class (located in the java.lang package). 

Math declares a pair of static constants and several static methods. 
Because of Math's privately declared constructor, it is not possible to create 
Math objects. Instead, Math serves as a utility class of mathematics capabili- 
ties. To access a constant or method, prefix that constant's or method's 
name with the Math, prefix. 

Math's constants include E and PI. E represents natural logarithm base value 
2.71828. . ., whereas pi represents the ratio of a circle's circumference to its 
diameter: 3.14159. . .. (The . . . indicates that an unending sequence of dig- 
its follows the decimal point of each transcendental number.) 
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\ I / The following code fragment prints out the value of E (to the limits of the 
IEEE 754 representation for that transcendental number) and uses pi in a 
calculation of the circumference of a circle: 

System. out. println (Math.E); 
double diameter = 50.0; 
double circumference = Math. PI * diameter; 
System. out. println (circumference) ; 

Math's methods range from computing absolute value to converting an angle 
from degrees to radians. Table 14. 1 lists those methods and provides 
descriptions of what they do. 

Table 14.1: Math Methods 



Method 



Description 



double abs(double a) 

float abs(float a) 

int abs{int a) 
long abs(long a) 
double acos(double a) 

double asin(double a) 

double atan(double a) 

double atan2{double a, 
double b) 

double ceilfdouble a) 



double cos(double a) 
double exp(double a) 

double floor{double a) 



double lEEEremainder 
(double f 1 , double f2) 
double log (double a) 
double max(double a, double b) 

float max(float a, float b) 



Return the absolute value of a, as a double-precision 
floating-point value. 

Return the absolute value of a, as a floating-point 
value. 

Return the absolute value of a, as an integer. 
Return the absolute value of a, as a long integer. 
Return the arc cosine of angle a, where the angle is 
in the range 0.0 through pi. 
Return the arc sine of angle a, where the angle is in 
the range -pi/2 through pi/2. 
Return the arc tangent of angle a, where the angle is 
in the range -pi/2 through pi/2. 
Convert rectangular coordinates (b, a) to polar 
coordinates (r, theta) and return theta. 
Return the smallest value (closest to negative infin- 
ity) that is not less than a and is equal to a mathe- 
matical integer. 
Return the cosine of angle a. 
Return the mathematical constant e raised to the 
power a. 

Return the largest value (closest to positive infinity) 
that is not greater than a and is equal to a mathe- 
matical integer. 

Compute the remainder of f 1 divided by f2 
(according to IEEE standards) and return the result. 
Return the natural logarithm (base e) of a. 
Return the maximum of a and b, as a double- 
precision floating-point value. 
Return the maximum of a and b, as a floating-point 
value. 
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Table 14.1: continued 



Method 



Description 




EXAMPLE 



int max{int a, int b) 
long max(long a, long b) 
double min(clouble a, double b) 

float min(float a, float b) 

int min{int a, int b) 
long min(long a, long b) 
double pow(double a, double b) 
double randomO 

double rint(double a) 

long round(double a) 

int round(float a) 

double sin(double a) 
double sqrt(double a) 
double tan (double a) 
double toDegrees (double a) 

double toRadians (double a) 



Return the maximum of a and b, as an integer. 
Return tlie maximum of a and b, as a long integer. 
Return the minimum of a and b, as a double- 
precision floating-point value. 
Return the minimum of a and b, as a floating-point 
value. 

Return the minimum of a and b, as an integer. 
Return the minimum of a and b, as a long integer. 
Return a raised to the power b. 
Return a randomly generated positive number that is 
greater than or equal to 0.0 and less than 1.0. 
Return a value that is closest to a and equal to a 
mathematical integer. 

Round a to a mathematical integer and return the 
result. 

Round a to a mathematical integer and return the 
result. 

Return the sine of angle a. 

Return the square root of a. 

Return the tangent of angle a. 

Convert angle a from radians to degrees and return 

the result. 

Convert angle a from degrees to radians and return 
the result. 



Math's methods are easy to use. For example, suppose you want to deter- 
mine the length of a right-angle triangle's hypotenuse. In other words, you 
want to know the length of the side that's directly opposite the right angle. 
That situation is illustrated in Figure 14.6. 

If you recall, the length of a right-angle triangle's hypotenuse is determined 
by the Pythagorean formula = + b^, where c represents the length of 
the hypotenuse. Using Java and the values in Figure 14.6, side a has length 
8 (11 - 3) and side b has length 12 (15 - 3). The following code fragment 
uses Math . sqrt () and those lengths to calculate the length of side c. 

double a = 8.0; 
double b = 12.0; 

double c = Math. sqrt (a * a + b * b); // 14.422205101855956 assigns to c 
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Figure 14.6: The length of a right-angle triangle's hypotenuse is specified by 
c, the side directly opposite the right angle. 

While browsing through the SDK documentation that pertains to the stan- 
dard class library, you'll probably encounter a class named StrictMath 
(located in the java.lang package). A closer look will show that StrictMath is 
identical, from a member perspective, to Math. Naturally, you might be won- 
dering why Java supports two virtually identically classes. The rationale is: 
Many of Math's methods (such as cos() and pow( )) aren't required to return 
identical bit-for-bit results on every Java-enabled platform. That flexibility 
exists so that different implementations of Math can be created that (inter- 
nally) use platform-specific libraries and microprocessor instructions to 
achieve a higher degree of performance. In contrast, equivalent StrictMath 
methods conform to standardized mathematics algorithms (available from 
the well-known network library net lib as the freely distributable math 
library f dlibm) and ensure identical results on all Java-enabled platforms. 
By the way, many of the methods in Sun's version of Math defer to 
StrictMath methods. For example, Math.expO calls StrictMath. exp( ). 

TIP 

If you are looking for mathematics performance and are not concerned with portability 
Issues, use Math. However, If portability Is more Important to you, use StrictMath. 



Random Numbers 



There is something exciting about the element of chance — whether you pre- 
fer playing a slot machine in a casino or racing dirt bikes in a motocross 
computer game, to see who will win. The element of chance is introduced to 
Java software by way of Math's random ( ) method. 

Math, random ( ) returns a double-precision floating-point value between 0.0 
(inclusive) and 1.0 (exclusive). In other words, the smallest return value 
is 0.0, and the largest return value is just shy of 1.0. The return value 
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represents a pseudorandom number — not a true random number. That 
number is pseudorandom because it's generated by way of a mathematical 
algorithm and not by way of a truly random source (like background radia- 
tion or thermal noise). Despite the fact that pseudorandom numbers are not 
truly random, computer scientists have devised mathematical algorithms 
that make sequences of pseudorandom numbers appear to be random. As a 
Java developer, you don't need to know how to create such an algorithm, 
because the work has been done for you — just call Math . random( ). 

The following code fragment demonstrates calling Math . random ( ) to return a 
pseudorandom number between 0.0 and (almost) 1.0, which subsequently 
assigns to variable n: 
EXAMPLE double n = Math . random (); 

In many situations, you will want to generate pseudorandom numbers from 
a range other than 0.0 to (almost) 1.0. For example, you might want to gen- 
erate pseudorandom numbers representing the throw of a die, and those 
numbers range from 1 through 6. You can accomplish that task through the 
process of scaling and shifting. 

The following code fragment calls Math . random ( ) and performs scaling 
and shifting to return a pseudorandom number that lies in the range 1 
through 6: 

EXAMPLE int value = (int) (Math. random () * 6) + 1; 

The code fragment's Math, random ( ) method call returns a pseudorandom 
number between 0.0 (inclusive) and 1.0 (exclusive). That number is multi- 
plied by 6 to scale it to a number ranging from 0.0 to (almost) 6.0. The 
resulting number is cast to integer, by way of (int), yielding an integer that 
ranges, from 0 to 5 (inclusive). Finally, 1 is added to the result, which shifts 
the integer into the range 1 through 6. That integer subsequently assigns 
to a variable. 

In general terms, (Math, random () * a) + b returns a pseudorandom num- 
ber in the inclusive range [b, a - 1 -i- b]: b represents the lowest value in the 
range and a - 1 h- b represents the highest value in that range. 

The following code fragment substitutes 101 for a and -50 for b, to return a 
pseudorandom number in the inclusive range -50 to 50: 
int n = (int) (Math. random () * 101) + -50; 

Math, random ( )'s return values are said to be uniformly distributed over the 
range 0.0 to (almost) 1.0. In other words, each value in that range has an 
equal chance of being returned. To prove to yourself that Math, random ( )'s 
return values are uniformly distributed, you need a program that calls 
Math, random ( ) (in a loop) to return pseudorandom numbers in a specific 





EXAMPLE 
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range and count each returned number. If those counts are similar, you can 
be assured that Math . random ( ) uniformly distributes returned numbers. 

\ I / Listing 14.1 presents source code to an application named DieTest. That 
1^1 application simulates 2000 rolls of a die and sums each returned number 
(from 1 through 6) separately. 



EXAMPLE 



Listing 14.1: DieTest. Java. 
// DieTest. java 

class DieTest 
{ 

public static void main (String [] args) 
{ 

int [ ] spots = new int [6] ; 

for (int i = 0; i < 2000; i++) 
spots [roll 0 - 1]++; 

for (int i = 0; i < spots. length; i++) 

System. out. println (i + 1 + " " + spots [i]); 

} 

static int roll () 
{ 

// Return a die value from 1 to 6. 
return (int) (Math. random () * 6) +1; 

} 

} 

When run, DieTest produces output similar to the following: 



2 340 
\r 3 325 
'"" 4 326 

OUTPUT 5 

6 351 



The output shows that each returned number's sum is similar to the other 
sums — and proves that Math, random ( ) returns pseudorandom numbers in a 
uniformly distributed manner. 
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EXAMPLE 




While browsing through the source code to the SDK's Math class, you will 
probably encounter source code similar to the following: 

private static Random randonNunberGenerator; 

private static synchronized void initRNG () 
{ 

if (randomNumberGenerator == null) 

randomNumberGenerator = new Random (); 

} 

public static double random () 
{ 

if (randomNumberGenerator == null) 
initRNG (); 

return randomNumberGenerator. nextDouble (); 

} 

That code fragment shows that Math implements random ( ) as a call to the 
nextDouble ( ) instance method of an object created from the Random class 
(located in the java.util package). Each Random object is capable of generat- 
ing an independent sequence of pseudorandom numbers. 

A Random object is constructed by calling either of two constructors: Random ( ) 
or Random (long seed). To understand what those constructors accomplish, 
you need to understand the concept of a seed. A seed is an integer that ini- 
tializes a pseudorandom number generator. Internally, a pseudorandom 
number generator uses a mathematical algorithm (known as a linear con- 
gruential formula) to return pseudorandom numbers. However, that 
algorithm requires a starting value — the seed — to get things going. The 
Random ( ) constructor initializes the seed to the current time. In contrast. 
Random (long seed) initializes the seed to its seed argument. For each seed, a 
Random object generates a unique sequence of pseudorandom numbers. That 
implies two Random objects, using the same seed, return identical sequences. 

The following code fragment creates a pair of Random objects: 

Random r1 = new Random (); // Use the current tine as the seed. 
Random r2 = new Random (50000); // Set the seed to 50000. 

Suppose you create a Random object and later want to change its seed. You 
can easily accomplish that task by calling Random's setSeed ( ) method. 

The following code fragment changes the seed in the first Random object — 
created in the previous code fragment — to 50000: 
n .setSeed (50000) ; 



EXAMPLE 
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EXAMPLE 



After you've constructed a Random object, you will want to return pseudoran- 
dom numbers. Random provides a variety of methods that return those num- 
bers, in different ways. For example, you can call nextDouble( ) to return a 
pseudorandom number that ranges from 0.0 to (almost) 1.0. Alternatively, 
you can call nextBoolean( ) to return either a Boolean true or false value. To 
get some idea of the methods that can be called, check out Table 14.2. 

Table 14.2: Random Methods 



Method 



Description 



boolean nextBoolean ( ) 

void nextBytes(byte [] bytes) 

double nextDoubleO 

float nextFloatO 

double nextGaussian ( ) 

int nextlntO 

int nextlnt(int n) 

long nextLongO 

void setSeed{long seed) 



Return the next pseudorandom and uniformly distrib- 
uted Boolean value. 

Generate random bytes and place them into the 
array referenced by the bytes argument. 
Return the next pseudorandom and uniformly distrib- 
uted double-precision floating-point value between 
0.0 (inclusive) and 1.0 (exclusive). 
Return the next pseudorandom and uniformly distrib- 
uted floating-point value between 0.0 (inclusive) and 
1.0 (exclusive). 

Return the next pseudorandom and Gaussian ("nor- 
mally") distributed double-precision floating-point 
value with mean 0.0 and standard deviation 1.0. 
Return the next pseudorandom and uniformly distrib- 
uted integer value. 

Return a pseudorandom and uniformly distributed 
integer value between 0 (inclusive) and the n argu- 
ment (exclusive). 

Return the next pseudorandom and uniformly distrib- 
uted long integer value. 

Set the seed of the pseudorandom number genera- 
tor to the contents of long integer argument seed. 



Table 14.2 implies that Random's nextlnt(int limit) method returns a 
sequence of pseudorandom numbers as integers ranging from 0 to one less 
than limit. That method is perfect for a program that shuffles cards. To see 
why, check out Listing 14.2's source code to the CardShuff ler application. 

Listing 14.2: CardShuffler. java. 
// CardShuffler. java 



import java.util.*; 



class CardShuffler 
{ 

public static void main (String [] args) 
{ 
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Listing 14.2: continued 

Deck d1 = new Deck ( ) ; 
d1 .display ( ) ; 
dl. shuffle 0; 
d1 .display ( ) ; 

Deck d2 = new Deck ( ) ; 
d2. display (); 
d2. shuffle 0; 
d2. display (); 

} 



class Card 
{ 

private String face, suit; 

Card (String face, String suit) 
{ 

this. face = face; 
this. suit = suit; 

} 

public String toString () 
{ 

return face + " of " + suit; 

} 



class Deck 
{ 

final static String [] faces = 
{ 

"Ace", "Deuce", "Three", "Four", "Five", 
"Six", "Seven", "Eight", "Nine", "Ten", 
"Jack", "Queen", "King" 

}; 

final static String [] suits = 
{ 

"Hearts", "Diamonds", "Clubs", "Spades" 

}; 



private Card [] deck = new Card [52]; 
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Listing 14.2: continued 

private static int count; 

private Random r = new Random (count++); 

Deck 0 
{ 

for (int i = 0; i < deck. length; i++) 

deck [i] = new Card (faces [i % faces. length] , 
suits [i / faces . length] ) ; 

} 

void shuffle () 
{ 

for (int i = 0; i < deck. length; i++) 
{ 

// Return an integer from 0 to deck. length - 1 (inclusive). 

int c = r.nextint (deck. length) ; 

Card temp = deck [i] ; 
deck [i] = deck [c] ; 
deck [c] = temp; 



void display {) 
{ 

for (int i = 0; i < deck. length; i++) 
System. out. println (deck [i]); 

System. out. println ("\n"); 

} 

} 

CardShuffler creates a pair of Deck objects in its rtiain( ) method. For each 
Deck object, that object's display () and shuffle () methods are called to dis- 
play the initial contents of the Deck, to shuffle the Deck, and to display the 
Deck's contents after the shuffle. Each Deck object creates a Random object 
and initializes that object with a seed obtained from a statically declared 
count field. Each time a Deck object is created, count increments. As a result, 
the next created Deck object will generate a different sequence of pseudo- 
random numbers. Within the shuffle() method. Random's nextlnt(int limit) 
method is called to return a pseudorandom number, as an integer, that 
ranges from zero to 51 (inclusive). 
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CardShuff ler uses Random objects instead of calling Math . random( ) because 
each Deck object should shuffle itself using a different sequence of pseudo- 
random numbers. That results in a program that "behaves" more randomly. 
However, if Math, random ( ) was used, all Deck objects would use the same 
global pseudorandom number sequence. (And how random would that be?) 



TIP 

If your program requires multiple sequences of pseudorandom numbers, it's better to 
create a Random object (with a different seed) for each sequence than to use 
Math . random ( ) . 



Because Random () is so versatile, why include a random () method in the Math 
class? The answer: simplicity. If your program requires only a single 
sequence of pseudorandom numbers, it is simpler to call Math . random ( ) . 



Big Decimals and Big integers 



The Java, math package contains a pair of classes, BigDecimal and Biglnteger, 
that are used to perform mathematical operations on arbitrary-precision 
numbers. If your program needs arbitrary-precision decimal numbers, use 
BigDecimal. But if your program requires arbitrary-precision integers, use 
Biglnteger. 



NOTE 

Sun uses BigDecimal and Biglnteger in its JDBC and security APIs. For example, the 
JDBC API's ResultSet interface declares a getBigDecimal() method that returns a 
reference to a BigDecimal object. Also, the security API's DSAPrivateKeySpec and 
DSAPublicKeySpec classes declare methods that return references to Biglnteger 
objects. 




EXAMPLE 



Big Decimals 

BigDecimal objects represent arbitrary-precision signed decimal numbers. 
Each object consists of an arbitrary-precision unsealed integer and a posi- 
tive 32-bit integer scale that specifies the number of digits to the right of 
the decimal point. To construct a BigDecimal object, call BigDecimal (String 
value). 

The following code fragment constructs a BigDecimal object with the 
BigDecimal(String value) constructor: 
BigDecimal bd = new BigDecimal ("1.0"); 

The value argument passed to BigDecimal(String value) has the following 
format. To begin, you can optionally specify a + or - character. That 
character is followed by zero or more digit characters that represent the 
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integer portion of the number. An optional fraction and an optional expo- 
nent follow. The fraction consists of a decimal point (a period character), fol- 
lowed by zero or more digit characters. The exponent consists of character e 
or E, followed by one or more digit characters. The exponent value, specified 
by those digits, must fall in the range denoted by Integer's MIN VALUE and 
MAX VALUE constants. 



CAUTION 

BigDecimal contains a BigDecimal( double value) constructor that should be avoided 
because the results of that constructor are unpredictable. For example, BigDecimal (0. 1 ) 
results in 0.1000000000000000055511151231257827021181583404541015625 being 
Stored instead of 0 . 1 — because 0 . 1 cannot be represented exactly as a double-precision 
floating-point value (or, for that matter, as a value of any finite floating-point precision). In 
contrast BigDecimal ("0.1") results in 0 . 1 being stored exactly because 0 . 1 is stored 
using integers. 



BigDecimal provides methods for performing mathematical operations on 
large decimal numbers. Those methods include: abs(), add(), divide(), 
maxO, min(), multiplyO, negateO, and subtract(). 

The following code fragment demonstrates a call to the add ( ) method, to 
add a big decimal number to itself: 
BigDecimal bd; 

bd = new BigDecimal ("9999999999999999999999999999999999999999999999.0"); 
bd = bd.add (bd); 

When you divide a big decimal number by another big decimal number, by 
calling divide( ), the number of digits that compose the resulting fraction 
might exceed the value specified by the scale. In that situation, rounding is 
required. Both the divide () and setScaleO methods offer complete control 
over the mode used to round fractions. BigDecimal's eight rounding mode 
constants are described in Table 14.3. 




EXAMPLE 



Table 14.3: Rounding Mode Constants 



Mode 



Description 



ROUND_CEILING 
ROUND_DOWN 
ROUND_FLOOR 
ROUND HALF DOWN 



ROUND HALF EVEN 



Round toward positive infinity. 

Round toward zero. 

Round toward negative infinity. 

Round toward "nearest neighbor" unless both 

neighbors are equidistant, in which case round 

down. 

Round toward "nearest neighbor" unless both 
neighbors are equidistant, in which case, round 
toward the even neighbor. 
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Table 14.3: continued 




EXAMPLE 



Mode 



ROUND_HALF_UP 
ROUND UNNECESSARY 



ROUND UP 



Description 



Round toward "nearest neighbor" unless both 
neighbors are equidistant, in which case round up. 
Assert that the requested operation has an exact 
result, hence no rounding is necessary. 
ROUND_UNNECESSARY is specified on an operation that 
yields an inexact result; an ArithmeticException 
object is thrown. 
Round away from zero. 



The following code fragment demonstrates divide ( ) and a pair of rounding 
modes: 



BigDecimal bd1 
BigDecimal bd2 



new BigDecimal {"10.545"); 
new BigDecimal {"1.1"); 



System. out. println 
System. out. println 



("RD: " + bd1 .divide (bd2, 
BigDecimal . ROUND_DOWN ) ) ; 
("RU: " + bd1 .divide (bd2, 
BigDecimal. ROUND_UP ) ) ; 



What do you think the scale might be for 10.545? Answer: three. After all, 
there are three fraction digits (545). Dividing 10.545 by 1 . 1 yields 9.58636. . . 
(where 36 keeps repeating forever). However, only three fraction digits are 
allowed in the result. Therefore, divide { ) must use a rounding mode to 
suitably round the fraction to three digits. The ROUND DOWN constant, in the 
first divide ( ) method call, suggests rounding toward zero. That results in 
9.586 being stored in the BigDecimal returned by divide( ). In contrast, the 
ROUND_UP constant, in the second divide ( ) method call, suggests rounding 
away from zero. That rounding mode results in 9 . 587 being stored. 

In addition to mathematics-related methods, BigDecimal provides conversion 
methods (such as doubleValue() and intValueO), informational methods 
(such as scale{), setScale{), and signum{)), and methods for manipulating 
the decimal point (such as movePointLeft( )). 



TIP 

You nnight be wondering when to use a double and when to use a BigDecimal object. 
To help you make that choice, keep the following in mind: Operations involving doubles 
are faster than operations involving BigDecimal objects. However, BigDecimal objects 
give you unlimited precision, whereas doubles give you between 15 and 17 digits of 
precision. 
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Big Integers 

Biglntegen objects represent arbitrary-precision signed integers. The format 
used to store those integers is the same as that used to store integers of 
primitive types, except that there is no theoretical Hmit to the number of 
bits that are allocated for holding a Biglnteger's value. To construct a 
Biglnteger object, call any of its six constructors. 

The following code fragment constructs a Biglnteger object with the 
Biglnteger(String value) constructor. Also, the value is retrieved, by calling 
toStringO, and printed: 

EXAMPLE Biglnteger bi = new Biglnteger {"98765432109876543210"); 
System. out. println (bi.toString {)); 

Biglnteger provides analogues to various primitive numeric integer math 
and bitwise operations by way of methods like add ( ) , mod ( ) , xor ( ) , and 
shif tLef t ( ) . The shift methods perform a faster mode of multiplication by 
powers of two. 

The following code fragment constructs a Biglnteger object and shifts it left 
by one bit. That is equivalent to multiplying by two: 
Biglnteger bi = new Biglnteger {"98765432109876543210"); 
EXAMPLE System. out. println (bi.toString {)); 
bi = bi.shiftLeft (1); 

System. out. println (bi.toString {)); // Output: 197530864219753086420 

Biglnteger provides methods that have no analogues among primitive inte- 
ger type operations. Those methods include gcd{) and isProbablePrime{ ). 
The gcd( ) method calculates the greatest common divisor of two big inte- 
gers, whereas isProbablePrime( ) determines whether a big integer is a 
prime number, based on a measure of uncertainty that the caller is willing 
to tolerate. 

The following code fragment calculates the greatest common divisor of two 
big integers: 

Biglnteger bil = new Biglnteger {"12345678900005"); 
EXAMPLE Biglnteger bi2 = new Biglnteger ("800"); 

System. out. println (bil.gcd (bi2) .toString ()); // Output: 5 

Java 2 SDK 1.4's Biglnteger class introduces a probablePrinne( ) static 
'\ 14 method that returns a Biglnteger probably representing a prime number. 
' - - - ' According to the SDK documentation: "The new prime-generation method 
provides an efficient algorithm for generating primes using an automati- 
cally determined, appropriate value for the certainty based on a draft ANSI 
specification (X9-80)." Check the SDK documentation for more information. 
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NOTE 

The Biglnteger and BigDecimal classes are related. If you browse through the SDK 
documentation for the BigDecimal class, you will encounter two constructors that take 
Biglnteger arguments. Furthermore, If you look through BigDecimal's source code, 
you will find that BigDecimal uses Biglnteger to hold the arbitrary-precision unsealed 
Integer portion of a big decimal. 



What's Next? 



The next chapter concludes our journey of exploration into Java's language 
and some of its many APIs by examining Java's File and Streams APIs. In 
that chapter, you will learn about serialization and externalization — and a 
whole lot more. 

Before you move on to the next chapter, test your understanding of the cur- 
rent chapter by completing the Reviewing It, Checking It, and Applying It 
activities. 



NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available In 
Appendix A, "Answers" at the end of the book. 




Reviewing it 



REVIEW 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. What is wrong with the technique used by Chapter I's Craps applica- 
tion to generate pseudorandom numbers? 

2. Why might it be beneficial to reproduce the same sequence of pseudo- 
random numbers? 

3. Why might you want to work directly with hexadecimal integer liter- 
als instead of decimal integer literals? (Example: int X = 0x80000000;) 

4. Why does BigDecimal bd = new BigDecimal (123.455); bd = 
bd.setScale (2, BigDecimal. ROUND_HALF_UP) ; System. out. println 
(bd .toString ( ) ) ; result in 123.45 printing instead of (the correct) 
123.46? 
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Checking It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. The expression 1 . 0 / 0 . 0 produces what? 

a. H-infinity 

b. -infinity 

c. NaN 

d. Overflow 

2. For which of the following declarations is it illegal to specify strictfp? 

a. Method declaration 

b. Field declaration 

c. Class declaration 

d. Interface declaration 

3. Which of the following IEEE 754 specification rounding modes does 
Java support? 

a. Round down to -infinity 

b. Round up to H-infinity 

c. Round to zero 

d. Round to nearest 

4. Which of the following statements is true? 

a. A twos-complement operation involves flipping bits and adding 
two. 




b. When dividing an integer value by integer zero, H-infinity returns. 
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c. An object initialized with the Random () constructor has its seed 
set to zero. 

d. A floating-point value's mantissa physically stores 23 bits. 

5. Which Math method can be used to represent the mathematical con- 
stant e? 

a. expO 

b. logo 

c. pow() 

d. atan2() 

6. Which BigDecimal rounding mode constant suggests only rounding 
away from zero? 

a. ROUND_CEILING 

b. ROUND_HALF_UP 
C. ROUND_UP 

d. ROUND_HALF_EVEN 

7. A normally distributed pseudorandom number is returned by which 
Random method? 

a. nextDoubleO 

b. nextGaussian ( ) 

c. nextFloatO 

d. nextBoolean( ) 

8. Which of the following Math methods rounds its argument to a mathe- 
matical integer? 

a. ceilO 

b. rintO 

c. roundO 

d. floorO 

9. What is the inclusive range of integers returned from (int) (Math, 
random () * 60) - 30? 

a. 0 to -30 

b. -30 to 29 
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c. -30 to 30 

d. 0to30 

10. Which of the following statements is false? 

a. A big integer can overflow. 

b. The BigDecimal (double value) constructor can lead to a big deci- 
mal with an inexact representation. 

c. Java does not support IEEE 754 "arithmetic exceptions." 

d. Math . sqrt ( - 1 ) does not result in an exception. 

True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. Java alerts program code to overflow and underflow conditions. 
True/False 

2. Math, random ( ) returns a different sequence of pseudorandom numbers 
each time a program containing that method call runs. 

True/False 

3. For a BigDecimal object constructed using BigDecimal (St ring value), 
the absence of a specified fraction implies that the scale ( ) method 
returns zero, to indicate no fraction digits. 

True/False 

4. FP-strict expressions are not portable across platforms. 
True/False 

5. Call Float's floatTolntBits() method to return a non-canonical NaN 
value. 

True/False 

6. Java's integer types are unsigned. 
True/False 

7. The range of the double-precision floating-point type is ±2.23+ 
lO-^o* to ±1.79+W\ 

True/False 
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8. The multiplicative operator % returns the remainder of either an inte- 
ger operation or a floating-point operation. 

True/False 

9. You can create objects from the Math class. 
True/False 

10. The rounding mode identified by BigDecimal's ROUND UNNECESSARY con- 
stant can result in AnithmeticException objects being thrown. 

True/False 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

1. Write a method named smallestDouble( ) that returns the smallest of 
three double arguments. That method must use Math . min ( ) to deter- 
mine which argument is smaller. 

2. Write a method named cube() that returns the cube of its double argu- 
ment. (Note: You cannot multiply the argument, three times in a row, 
as in X * X * x.) 

3. Write code fragments, involving Math . random( ), that return random 
numbers in the following ranges: 

a. -1 <= X <= 1 

b. 0 <= X < 1000 

c. -10 < X < 0 

4. Math.floor( ) can be used to round a value to the nearest integer. That 
is accomplished by adding 0.5 to a value and then calling Math.floor( ) 
on the result. (Example: Math. floor (3.6 + 0.5) produces 4.) Write 
expressions that use Math.floor() to round 1 .5463 to the tenths, hun- 
dredths, and thousandths positions. 

5. Given declaration Biglnteger bi = new Biglntegen ( " - 1 29" ) ; , write a 
code fragment that extracts individual bits (in a left-to-right order and 
beginning with the sign bit) from the big integer's internal representa- 
tion and prints I's or O's (as appropriate) so that a bit representation 
of -129 appears. (Hint: Check the SDK documentation for Biglnteger 
methods that obtain the length of a big integer and test its bits. Also, 
the result should equal 101111111.) 
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6. Given declaration Biglnteger bi = new Biglnteger ( " - 1 29" ) ; , write a 
code fragment that prints the sign of that number and prints the num- 
ber in hexadecimal notation. (Hint: Use Biglnteger methods only.) 

7. Create a Guess application that pseudorandomly generates an integer 
representing a letter in the inclusive range A through Z. Then, by way 
of System . in . read ( ) , try to guess that letter. Print a suitable message if 
the guess is too low, too high, or just right. Furthermore, if the guess 
is correct, exit the program. 
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Files and Streams 

Files offer long-term persistence of data items. Streams serve as conduits 
by which data items flow between programs, files, and other entities. 
Sometimes, a program must have its execution state (as represented by 
objects) fi:'ozen, through a process known as object serialization. At a later 
point in time, fi:'ozen objects are reconstructed through deserialization, and 
the program resumes its execution fi^om the moment it fi"oze. Finally, cer- 
tain kinds of programs (such as compilers) need to break a stream of char- 
acters into tokens. Stream tokenizers accomplish that task. All of those 
concepts are explored in this chapter. 



NOTE 

Among the more anticipated features in version 1.4 of Java 2 Standard Edition are tine 
new I/O classes. Those classes allow you to accomplish a variety of tasks, including 
nonblocking I/O and memory-mapped buffers. For various reasons, none of that mater- 
ial has made it into this book (although it will make it into future editions of Java 2 By 
Example). Instead, I encourage you to read the JavaWorld article. Master Merlin's new 
I/O classes (http : / / www. j avaworld . com / j avaworld/ jw-09 - 2001 / jw-0907 - 
merlin. html) for a fun-filled tour of Java's new I/O classes. 
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Working with Fiies 



Computer languages are commonly used to create programs that work with 
files. A file serves as a unit of storage on some permanent storage medium 
(such as a diskette, a hard-drive, or a CD-ROM), and consists of a name, 
attributes, and a byte sequence that serves as the file's contents. Figure 
15.1 conceptualizes a file. 



^ employee.dat 




Figure 15.1: The organization of a file (such as employee .dat) includes a 
name, attributes (such as hidden and read-only), and a reference to a 
sequence of bytes that contain the file's data items. 



Files can be categorized as either data files or directory files. The 
difference between those categories is that a data file holds any kind of 
data, and a directory file holds only data files and other directory files. 
Various operations can be performed on either file's name and attributes. 
Name operations include rename and check to see whether the file 
exists. Attribute operations include delete and check to see whether the 
file is hidden. For data files, content operations can also be performed, 
including open, read, write, and close. Those content operations can be 
applied to both sequential-access and random-access data files. In addi- 
tion to the aforementioned content operations, random-access data files 
allow for the content operations of seeking the file pointer to a specific 
byte and retrieving the current file pointer value. The following sections 
explore name and attribute operations and sequential-access and random- 
access data file content operations. 
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Name and Attribute Operations 

If you ever need to perform an operation on either a file's name or its 
attributes, you will want to investigate Java's File class (located in the 
java.io package). The File class declares methods that perform name and 
attribute operations exclusively on data files, exclusively on directory files, 
or on both kinds of files. 



NOTE 

Developers who are new to Java sometimes think that the File class can be used to 
read and write data files. However, File does not offer data file read and write capabili- 
ties, because reading and writing data files are not its tasks. 



An examination of the File class shows the presence of four class fields: 
pathSeparator, pathSeparatorChar, separator, and separatorChar. Those fields 
help overcome a pair of problems that violate Java's architecture neutrality: 

• The pathSeparator and pathSeparatorChar fields represent the platform- 
dependent path-separator character as both a string and a character, 
respectively. The path-separator character refers to the character used 
to separate directory names in a path list. Under Unix or Linux, that 
character is a colon, whereas that character is a semicolon on 
Windows platforms. Because the literal specification of either a colon 
or a semicolon in your source code binds your Java program either to 
Unix/Linux or to Windows, it is better to specify File. pathSeparator or 
File. pathSeparatorChar if portability is your goal. 

• The separator and separatorChar fields represent the platform-dependent 
separator character that separates directory names from other direc- 
tory names (and an optional data filename) in a pathname. Under 
Windows, that character is a backslash, whereas that character is a 
forward slash under either Unix or Linux. As with literally specifying 
a path-separator character in source code, it is not a good idea to liter- 
ally specify a separator character. Instead, you should specify 

File . separator or File . separatorChar. 

In addition to its four class fields. File declares three class methods — a cou- 
ple of overloaded createTempFileO methods and a listRoots() method — and 
a variety of instance methods. Although you do not need a File object to call 
any of File's three class methods, you will need that object to call its 
instance methods. To initialize a File object during its creation, call either 
of three constructors: 
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• The File(String pathname) constructor takes the contents of its 
pathname argument and converts it into an abstract pathname. That 
abstract pathname represents a pathname that is considered platform- 
independent. If pathname references a String object that contains no 
characters, the resulting abstract pathname is said to be empty. 
However, if pathname contains null, File(String pathname) throws a 
NullPointerException object. 

• Sometimes, you might find it more convenient to call File (String parent, 
String child). That constructor allows you to specify a pathname in 
two parts: The parent pathname can refer to all directories except for a 
data filename, and the child pathname can refer to the data filename 
only. Internally, File (String parent, String child) creates an abstract 
pathname that merges child with parent. If parent contains null, the 
abstract pathname consists solely of child. However, if child contains 
null, File(String parent, String child) throws a NullPointerException 
object. 

• Finally, you might find yourself with an existing File object and want 
to create a new File object consisting of the existing File object's 
abstract pathname and the child pathname. You can accomplish that 
task by calling the File (File parent, String child) constructor. As 
with the previous constructor, if parent contains null, the abstract 
pathname consists solely of child. However, if child contains null, 
File(File parent, String child) throws a NullPointerException object. 

Perhaps the simplest way to learn the File class is to divide its methods 
into two categories and explore each category separately. The abstract path- 
name category contains methods that either manipulate or return various 
components of an abstract pathname. In contrast, the file-manipulation cat- 
egory contains methods that manipulate data files and directories. We 
begin exploring File by focusing on its abstract pathname methods. 

Abstract Pathname Methods 

Every File object contains an abstract pathname that represents a platform- 
independent view of a path to either a data file or a directory. After a File 
object is created, the abstract pathname never changes. Therefore, a File 
object is said to be immutable. Before you can fully understand File's 
abstract pathname methods, there are a few things you need to know about 
abstract pathnames: 

• An abstract pathname begins with an optional system-dependent pre- 
fix string (such as a Windows drive letter and colon, a Unix root direc- 
tory specifier (/), or a Windows UNC [Universal Network Convention] 
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specifier [\\]) and continues with a sequence of zero or more names. 
System-dependent prefix strings make it possible to access files on 
specific local or network drives (under Windows) or relative to the root 
directory, instead of some arbitrary directory (under Unix). 

• Apart from the final name in the sequence, each name identifies a 
directory. The final name identifies either a directory file or a data file. 
If the abstract pathname contains no prefix string and no name 
sequence, the abstract pathname is said to be empty. (In a UNC 
abstract pathname, the first two names are the host name and the 
share name.) 

• When a platform-dependent pathname string is converted into an 
abstract pathname, the names within that platform-dependent path- 
name may be separated by the default name-separator character (as 
identified by the file . separator system property — which is copied into 
File's separator and separatorChar fields) or any other name separator 
character that is supported by the underl3dng platform. 

• When an abstract pathname is converted into a pathname string, each 
name is separated from the next by a single copy of the default sepa- 
rator character. 



• Platform-dependent and abstract pathnames can be either relative or 
absolute. A relative pathname is resolved against another pathname to 
determine the location of a data file or a directory. By default, that 
other pathname is the current user directory pathname — identified by 
the user.dir system property — and is typically the directory from 
which the JVM loads. In contrast, an absolute pathname requires no 
other information to locate a data file or a directory: It is complete. 

• Under Unix or Linux, the prefix of an absolute pathname is always 
the root directory symbol (/) and a relative pathname has no prefix. 
Under Windows, the prefix of an absolute pathname is either an 
optional drive specifier (consisting of a drive letter followed by a colon 
character) followed by the root directory symbol (\), or a UNC 
sequence (W followed by host and share names). Also, a relative path- 
name without a drive specifier has no prefix. 



Now that you know about abstract pathnames, it is time to investigate 
File's abstract pathname methods. Table 15.1 presents those methods. 
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Table 15.1: File's Abstract Pathname Methods 



Method 



Description 



int compareTo(File f) 



File getAbsolutePileO 

String getAbsolutePath { ; 
File getCanonicalFile( ) 



String 

getCanonicalPath ( 



String getNameO 
String getParentO 

File getParentFile( ) 
String getPath() 



Connpare the abstract pathname of the file associated with 
the File object referenced by f to the abstract pathname of 
the file associated with the current File object. Comparison 
is lexicographic, and the ordering depends on the underlying 
platform: Unix/Linux treats uppercase/lowercase letters as 
distinct, whereas Windows does not. Return a negative 
value if the current File object's abstract pathname is lexi- 
cographically less than the abstract pathname of the File 
object referenced by f , a positive value if the current File 
object's abstract pathname is lexicographically greater than 
the abstract pathname of the File object referenced by f, 
or zero if both abstract pathnames are identical. 
Return a File object that contains the absolute abstract 
pathname of the current File object. (Equivalent to new 
File (this.getAbsolutePathO).) 
Return the absolute (that is, non-relative) form of the cur- 
rent File object's abstract pathname. 
Return a File object that contains the canonical (that is, 
standardized) abstract pathname of the current File object. 
(It is possible for a data file or a directory to be accessed 
via multiple pathnames. However, only one of those path- 
names is considered to be standardized.) Throw an 
lOException object if an I/O error occurs while making file- 
system queries necessary to the creation of a canonical 
pathname. (Equivalent to new File 
(this. getCanonicalPath ( ) ) .) 

Return the canonical form of the current File object's 
abstract pathname. Throw an lOException object if an I/O 
error occurs while making file-system queries necessary to 
the creation of a canonical pathname. 
Return the name component of the current File object's 
abstract pathname. 

Return the parent pathname component of the current File 
object's abstract pathname or null if the abstract pathname 
does not include a parent pathname component. 
Return a File object containing an abstract pathname that 
consists of the parent pathname component of the current 
File object's abstract pathname, or null if the abstract path- 
name does not include a parent pathname component. 
Return the path component of the current File object's 
abstract pathname. 
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Table 15.1: continued 



Method 



Description 




EXAMPLE 



boolean isAbsolute() 



URL toURLO 



Return true if the current File object's abstract pathname 
is absolute. Under Unix or Linux, an absolute pathname is 
a pathname that has a / prefix. Under Windows, an 
absolute pathname is a pathname that has a prefix consist- 
ing of either a drive specifier followed by a \ or a UNC 
specifier \\. 

Convert the current File object's abstract pathname to a 
file: URL (Uniform Resource Locator — the symbolic 
address of a resource) and return a reference to a URL 
object that contains that URL. The URL will end with a back- 
slash character if toURL() determines that the abstract 
pathname represents a directory. If the abstract pathname 
cannot be parsed into a URL, toURL() method throws a 
Malt ormedURLException object. 

A good way to become familiar with abstract pathname methods is to play 
with an application that allows you to specify a path and then calls abstract 
pathname methods to return different kinds of information about that path. 
The Pathinf 0 source code in Listing 15.1 demonstrates those methods. 

Listing 15.1: Pathinf o.java. 
// Pathlnfo. java 



impor't java.io.*; 

class Pathlnfo 
{ 

public static void main (String [] args) throws lOException 
{ 

if (args . length != 1 ) 
{ 

System. out. println ("usage: java Pathlnfo path"); 
return; 

} 

File f = new File (args [0]); 



System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 
System. out. println 



"Absolute path = " + f .getAbsolutePath ()); 
"Canonical path = " + f .getCanonicalPath () 
"Name = " + f .getName ( ) ) ; 
"Parent = " + f.getParent ()); 
"Path = " + f.getPath ()); 
"Absolute? = " + f.isAbsolute ()); 
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To understand Pathlnfo, consider the following scenario: Suppose you are 
running Windows and suppose that your current directory (on the C: drive) 
is \Reports\January. If you type java Pathlnfo ..\February, Pathlnfo outputs 
the following details: 

..^ Absolute path = C:\Reports\January\..\February 

jyTB^ Canonical path = C:\Reports\February 
^j'^.Xf Name = February 

Parent = . . 

OUTPUT pg^h = . .\February 
Absolute? = false 

The first thing to note about the output is that it appears in a platform- 
specific (notably Windows-specific) format. That occurs because File's "get" 
methods convert abstract pathname details to platform-dependent path- 
name details. Second, the absolute path merges the current Windows direc- 
tory C: \Reports\January with the specified relative path . . \Febnuary. In 
contrast, the canonical path is the standardized path that runs from the 
root directory on drive C: to directory February. The name component of the 
. . \February pathname is February and . . \February is the path. Finally, 
. . \ February is not an absolute path — it is a relative path. 

NOTE 

The term canonical path might seem confusing but is simpler than you might think. A 
canonical path refers to the simplest absolute pathname of a file. For example, 
C: \Reports\January\ . . \February and C: \Reports\February are absolute path- 
names to the directory file named February. However, C: \Reports\February is 
regarded as the canonical pathname because it is the simplest absolute pathname 
from the root directory to February on the C: drive. 



File-Manipulation Methods 

File declares a variety of methods that manipulate data files and directo- 
ries. Methods range from determining whether a file can be read or 
written to setting a file's read-only attribute. For a glimpse of File's 
file-manipulation methods, check out Table 15.2. 

Table 15.2: File's File-Manipulation Methods 

Method Description 

boolean canReadO Return true if the file associated with the current File 

object exists and can be read, 
boolean canWriteO Return true if the file associated with the current File 

object exists and can be written. 
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Table 15.2: continued 



Method 



Description 



boolean createNewFile ( 



File createTempFile 
(String prefix, 
String suffix) 

File createTempFile 
(String prefix, 
String suffix, 
File directory) 



boolean deleteO 
void deleteOnExit { ) 

boolean existsO 
boolean isDirectory( ) 
boolean isFileO 



Check for the existence of a data file located and named by 
the current File object's abstract pathname. If such a data 
file does not exist, create the data file. The existence check 
and creation code is considered to be a single atomic oper- 
ation. When createNewFile 0 is used in conjunction with 
deleteOnExit 0 , it is possible to achieve a simple but reli- 
able cooperative data file-locking protocol. If an I/O error 
occurs, an lOException object is thrown. 
Call the three-argument createTempFile ( ) method with 
null as that method's directory argument. Passing 
null identifies the default temporary data file 
directory. 

Create an empty data file in the directory identified by 
the directory argument. The prefix argument 
specifies the first few characters of the temporary 
data file's name and must be at least three characters long. 
The suffix argument specifies the data file extension. If 
null is passed, .tmp is used as the extension. The abstract 
pathname of the new data file returns in a File object. If 
the length of the String object referenced by the prefix 
argument is less than three characters, throw an 
IllegalArgumentException object. If the data file could not 
be created, throw an lOException object. However, if the 
method returns successfully, it guarantees that the data file 
located and named by the current File object's abstract 
pathname did not previously exist and that neither 
createTempFile ( ) method will generate the same abstract 
pathname during the current JVM invocation. 
Delete the file located and named by the current File 
object's abstract pathname. Return true if the file was suc- 
cessfully deleted. 

Request that the file located and named by the current File 

object's abstract pathname be deleted when the JVM exits 

in a normal manner. The deleteOnExit { ) method can be 

used with createNewFile ( ) to achieve a simple but reliable 

cooperative data file-locking protocol. 

Return true if the file located and named by the 

current File object's abstract pathname exists. 

Return true if the current File object's abstract pathname 

refers to an existing directory. 

Return true if the current File object's abstract pathname 
refers to an existing file. 
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Table 15.2: continued 



Method 



Description 



boolean isHidclen( 



long lastModif led { ) 



long length ( 



String [] list() 



String [] list 
(FilenameFilter f) 



File [] listFilesO 



File [] listFiles 
(FileFilter f) 



Return true if the current File object's abstract pathname 
refers to an existing file that is hidden. Under Unix, a file is 
considered to be hidden if its name begins with a period 
character. Under Windows, a file is considered hidden if it is 
marked hidden in the file system's entry for that file's 
descriptor. 

Return the time, measured in milliseconds from January 1, 
1970 00:00:00 GIVIT, that the file, identified by the current 
File object's abstract pathname, was last modified, or zero 
if the file does not exist (or if some I/O error occurs). 
Return the length of the data file identified by the current 
File object's abstract pathname or zero if the data file does 
not exist. 

Return an array of String objects, where each String 
object contains the name of a file located in the directory 
identified by the current File object's abstract pathname 
(and does not include path information). If the current File 
object's abstract pathname does not identify a directory (or 
if an I/O error occurs), null returns. The array does not 
include the name of the abstract pathname directory or its 
parent directory, and there is no guarantee as to the order 
of returned names. 

Same as the previous list() method except that only 
names satisfying the FilenameFilter object referenced by f 
return. If f contains null, all names are accepted. 
Othenwise, a name returns only if FilenameFilter's 
accept 0 method returns true for that name. 
Return an array of File objects containing abstract path- 
names for all files located in the directory identified by the 
current File object's abstract pathname. Each returned 
File object contains an abstract pathname for one of those 
files. If the current File object's abstract pathname identi- 
fies a data file instead of a directory (or if an I/O error 
occurs), null returns. The array does not include the name 
of the abstract pathname directory or its parent directory, 
and there is no guarantee as to the order of returned 
names. 

Same as the previous listFilesO method except that 
a File object returns if the FileFilter object's (as refer- 
enced by f) accept 0 method returns true for that name. 
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Table 15.2: continued 



Method 



Description 




File [] listFiles 
(FilenameFilter f) 

File [] listRootsO 



boolean mkdir() 
boolean mkdirsO 



EXAMPLE 



Same as the previous listFiles () method except that 
a File object returns if the FilenameFilter object's (as ref- 
erenced by f) accept {) method returns true for that name. 
Return an array of File objects that identify the root directo- 
ries of all available filesystems. On a Unix or Linux platform, 
there is a single filesystem as specified by the root direc- 
tory {/). On a Windows platform, each active drive repre- 
sents a separate filesystem. If filesystem roots cannot be 
obtained, return null. 

Create the directory named by the current File object's 
abstract pathname. Return true if the directory was created. 
Create the directory named by the current File object's 
abstract pathname, including any nonexistent parent directo- 
ries. Return true if the directory and any needed parent 
directories were created. If false returns, the directory is not 
created, although some nonexistent parent directories might 
be created. 

Rename the abstract pathname in the current File object 
to the abstract pathname contained in the File object iden- 
tified by dst. Throw a NullPointerException object if dst 
contains null. Return true if the operation succeeded. 
Set the last-modified time of the data file identified by 
the current File object's abstract pathname to time. If time 
contains a negative value, throw an 
IllegalArgumentException object. 

Mark the file identified by the current File object's abstract 
pathname so that only read operations are allowed. After 
setReadOnly ( ) is called, the file is guaranteed not to 
change until it is either marked for write access or deleted 
(provided that the underlying platform permits a read-only 
file to be deleted). Return true if the operation succeeded. 

Among its various methods, Table 15.2 presents setLastModified( ) — a 
method that sets a data file's last modified time to a specific value. 
Over the years, various programs have been written to change the last 
modified time for one or more data files. Those programs are known as 
touch utilities. The Touch source code in Listing 15.2 shows how to use 
setLastModified( ) in a Java-based touch utility. 



boolean renameTo 
(File dst) 



boolean setLastModif led 
(long time) 



boolean setReadOnly ( ) 
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Listing 15.2: Touch . j ava. 
// Touch.] ava 

import java.io.*; 
import java.util.*; 

class Touch 
{ 

public static void main (String [] args) 
{ 

String [] names = new File {"."). list (); 

Date current = new Date (); 

for (int i = 0; i < names. length; i++) 
{ 

File f = new File (names [i]); 

f . setLastModif led (current. getTime ()); 

} 

} 

} 

When run, Touch calls list ( ) to return a list of all files in the current direc- 
tory. Touch then creates an object from the Date class (located in the 
java.util package) that contains the current date and time. For each 
returned file, Touch attempts to change its last modified time to the time 
contained in the Date object. 



NOTE 

Touch introduces a class that is not discussed in this booi<: Date. The reason why Date 
is not discussed is that it belongs to a larger Java topic known as internationalization — 
and a complete treatment of internationalization is beyond the scope of this book. If 
you would like to learn more about Date (and internationalization), I encourage you to 
read a three-part Internationalize Your Software article series I wrote ior JavaWorld in 
1998-1999. To find that series, visit my Java Jeff Web site (http: / /www. 
i avajeff.com) and click the Articles button on the main Web page. From the Articles 
Web page, click on either lYS article link. (The third article in that series discusses 
Date.) 



Sequential-Access Data File Content Operations 

A data file can be opened for sequential read or write access. As an exam- 
ple, a large company maintains payment details for each of its employees in 
a payroll file. When it comes time to pay those employees, the company's 
payroll department runs a check-printing program. The check-printing pro- 
gram reads the first employee's payment details, prints a check for that 
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employee, reads the second employee's payment details, prints a check, and 
so on — in sequential order. To make that happen, the payroll file is opened 
for sequential read access. 

When a data file is opened for sequential read access, an internal file 
pointer is positioned to identify the first byte in the file. After the first byte 
has been read, the file pointer is automatically positioned to the second 
byte. That process continues until the last byte has been read. At that 
point, the file closes. When opened for sequential write access, either a new 
file is created (if it did not previously exist) or an existing file's contents are 
erased. The file pointer positions itself to the start of the file and keeps 
incrementing as bytes are written. After the last byte has been written, the 
file closes. Java supports sequential-access read, write, and other content 
operations by way of its FilelnputStream, FileOutputStream, FileReader, and 
FileWriter classes. Because those classes involve the concept of streams, an 
example of sequential-access is postponed until file streams are discussed 
(later in this chapter). 

Random-Access Data File Content Operations 

A data file can be opened for random read and write access. As an example, 
a company maintains employee details for each of its employees in an 
employee file. By opening that file for random read and write access, it is 
possible to update an employee's address, then fetch another employee's 
social security number (or equivalent), and finally delete those details cor- 
responding to an employee that has just retired, without having to close 
and reopen the employee file between successive read and write tasks. 

When a data file is opened for random read and write access, an internal 
file pointer is positioned to identify the first byte. By using a random-access 
content operation known as seek, that file pointer can be positioned to 
another byte (ranging from zero — the position of the first byte — to one less 
than the length of the file). After the file pointer has been repositioned, it is 
a simple matter to either read a byte from or write a byte to the new loca- 
tion. Java supports random-access read, write, and other content operations 
by way of its RandomAccessFile class (located in the j ava . io package). 

Initialize a RandomAccessFile object during its creation by calling either of 
two constructors. The RandomAccessFile(String name, String mode) construc- 
tor takes a name argument that identifies the location and name of the file 
to be opened for random access and a mode argument that identifies the 
manner in which the file is opened — for read access only or for read and 
write access. The RandomAccessFile (File name, String mode) constructor is 
similar to the previous constructor except for a File argument whose 
abstract pathname identifies the location and name of the file. Either 
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EXAMPLE 



constructor throws a FileNotFoundException object if the file cannot be 
found. Furthermore, if mode is not one of "r" (read-only) or "rw" (read-write), 
either constructor throws an lllegalArgumentException object. 

CAUTION 

Do not call RandomAccessFile's "write" methods if you liave initialized a 
RandomAccessFile object for read-only access. Any attempts to call the "write" meth- 
ods on read-only random-access files causes those methods to throw lOException 
objects. Similarly, if you only intend to read a random-access file, open that file using 
read-only mode instead of read-write mode. That way, the file will never be modified if 
you happen to accidentally introduce file-modification code. 

Random-access files are not often used to read and write bytes in a random 
fashion. Instead, they are typically used to read and write larger aggregates 
of data: integers, floating-pointing numbers, strings of characters, and so 
on. For that reason, RandomAccessFile implements a pair of Datalnput and 
DataOutput interfaces that identify read and write methods for reading and 
writing different types of data. Examples of those methods include 
readBoolean( ), writeChars( ), readUnsignedShort ( ), and writeDouble( ). Along 
with read and write methods, RandomAccessFile includes methods for 
retrieving the length of a random-access file (length ()), retrieving the cur- 
rent file pointer position (getFilePointer()), seeking (that is, moving the file 
pointer) to a new position (seek ()), closing the file (close ( ) ), changing the 
length of the file (setLength( )), and so on. To become comfortable with 
RandomAccessFile's methods, you are encouraged to investigate the SDK 
documentation and see what it has to say about that class. 

The RandomAccessFile class can serve as the basis for a flat-file database 
(that is, a repository of record-oriented data files with no support for 
advanced database operations, like transaction management). Flat-file 
databases typically organize their files into sequences of fixed-length 
records, where each record describes some entity (such as an employee). 
Furthermore, records are often divided into sequences of fixed-length fields, 
where each field describes some attribute of the entity (such as an 
employee's name, address or salary). To give you an idea of what a flat-file 
database file looks like. Figure 15.2 shows the organization of a file that 
holds employee records. 

Suppose we want to write an application that creates and manipulates a 
flat-file database. To begin, we need some way to represent a record in 
source code. The EmployeeRecord class source code in Listing 15.3 shows how 
to accomplish that task. 
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Fields 



Records 




Lastname 


Firstname 


Address 


Age 


Salary 


Smith 


John 


Box 1 00 


46 


59000.0 


Jones 


George 


55 Peach Street 


59 


68000.0 




Gore 


Joe 


Box 1 99 


55 


23423.0 



Figure 15.2: A flat-file database consists of one or more data files, where 
each data file is divided into a series of fixed-length records, and each record 
is divided into a series of fixed-length fields. 



Listing 15.3: EmployeeRecord.java. 
// EmployeeRecord. java 



import java.io.*; 



class EmployeeRecord 
{ 

static int MAXLEN_LNAME 
static int MAXLEN_FNAME 
static int MAXLEN_ADDR 

private String lastName; 
private String firstName; 
private String address; 
private byte age; 
private double salary; 

void read (RandomAccessFile raf) throws lOException 
{ 

// Read lastname field. 



= 15; 
= 15; 
= 30; 



char [] temp = new char [MAXLEN_LNAME] ; 
for (int i = 0; i < temp. length; i++) 
temp [i] = raf.readChar (); 
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Listing 15.3: continued 

lastNartie = new String (temp); 

// Read firstname field. 

temp = new char [MAXLEN_FNAME] ; 
for (int i = 0; i < temp. length; i++) 
temp [i] = raf.readChar {); 

firstName = new String (temp); 

// Read address field. 

temp = new char [MAXLEN_ADDR] ; 
for (int i = 0; i < temp. length; i++) 
temp [i] = raf.readChar (); 

address = new String (temp); 

// Read age field. 

age = raf . readByte ( ) ; 

// Read salary field. 

salary = raf . readDouble (); 

} 

void write (RandomAccessFile raf) throws lOException 
{ 

StringBuffer sb; 

// Write lastname field. 

if (lastName != null) 

sb = new StringBuffer (lastName); 

else 

sb = new StringBuffer (); 
sb.setLength (MAXLEN_LNAME) ; 
raf .writeChars (sb.toString ()); 
// Write firstname field, 
if (firstName != null) 
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Listing 15.3: continued 

sb = new StringBuffer (firstName); 

else 

sb = new StringBuffer {); 

sb.setLength (MAXLEN_FNAME) ; 

raf .writeChars (sb.toString {)); 

// Write address field. 

if (address != null) 

sb = new StringBuffer (address); 

else 

sb = new StringBuffer (); 
Sb.setLength (MAXLEN_ADDR) ; 
raf .writeChars (sb.toString ()); 
// Write age field, 
raf .writeByte (age); 
// Write salary field, 
raf .writeDouble (salary); 

void setAge (byte age) 
this. age = age; 

byte getAge () 
return age; 

void setAddress (String address) 
this. address = address; 

String getAddress () 
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Listing 15.3: continued 
return address; 



void setFirstName (String firstName) 
this .f irstName = firstName; 

String getFirstName () 
return firstName; 

oid setLastName (String lastNane) 
this.lastName = lastName; 

String getLastName () 
return lastName; 

oid setSalary (double salary) 
this. salary = salary; 

double getSalary () 
return salary; 

nt size () 

return 2 * (MAXLEN_LNAME + MAXLEN_FNAME + MAXLEN_ADDR) + 9; 



} 

EmployeeRecord encapsulates an employee record as a lastname, a firstname, 
an address, an age, and a salary field. A pair of read() and write () methods 
are declared to handle the tasks of reading or writing an employee record 
from and to a random-access file. Those methods are designed to handle sit- 
uations in which not all field variables are initialized. For example, if 
lastName is not initialized, write () outputs a sequence of null bytes to the 
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file. Furthermore, those methods ensure that each string field does not 
exceed a certain fixed length (as identified by the "MAXLEN" constants). It 
is important that all fields have fixed lengths to facilitate setting the file 
pointer to the start of individual records. 



NOTE 

The use of the term "field" to refer to a record's attribute and to a variable declared in 
a class is an example of using a term to refer to different things. That practice is com- 
mon in computer science, and can become confusing. However, in the current scenario, 
the overloaded use of field should not be confusing if you think of an object's field vari- 
able as being equivalent to a record's field. 



In addition to read() and write(), EmployeeRecord introduces methods that 
make it possible to set and get field variable values, as well as a size( ) 
method whose purpose is to help in determining how many records are 
stored in a file — as you will see. 

By itself, EmployeeRecord accomplishes nothing. We need some code that cre- 
ates an employee file, consisting of employee records. To accomplish that 
task. Listing 15.4 presents source code to the CreateEmployeeFile application. 
That application builds employee records and writes them to a random- 
access file. 

Listing 15.4: CreateEmployeeFile. java. 
// Cr'eateEnployeeFile. java 



impor't java.io.*; 



class Cr'eateEnployeeFile 
{ 

public static void main (String [] args) 
{ 

String [] f names = 
{ 

"John" , 
"George" , 
"Sally", 
"Bill", 
"Trudy" , 
"Janet" , 
"Joe" 

}; 

String [] Inames = 
{ 

"Smith" , 
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Listing 15.4: continued 

"Jones" , 
"Disney" , 
"Flinstone" , 
"Bush" , 
"Clinton" , 
"Gore" , 

}; 

string [] addresses = 
{ 

"Box 100", 

"55 Peach Street" , 

"6 Drury Lane" , 

"Apt. 509, 200 Centennial", 

"P.O. Box 3567", 

"90 Carlton Ave. " , 

"Box 199" 

}; 

byte [] ages = 
{ 

46, 
59, 
32, 
26, 

41, 
37, 
55 

}; 

double [] salaries = 
{ 

59000.0, 
68000.0, 
32000.0, 
43233.0, 
12345.0, 
23443.0, 
23423.0 

}; 

RandomAccessFile raf = null; 

try 
{ 

raf = new RandomAccessFile ("employee.dat", "rw"); 
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Listing 15.4: continued 

EmployeeRecord er = new EmployeeRecord (); 

for (int i = 0; i < fnanes. length; i++) 
{ 

er.setFirstNane (fnanes [i]); 
er.setLastName (Inanes [i]); 
er.setAddress (addresses [i]); 
er.setAge (ages [i]); 
er.setSalary (salaries [i]); 
er. write (raf); 

} 

} 

catch (lOException e) 
{ 

System. out. println (e.toString ()); 

} 

finally 
{ 

if (raf != null) 
try 

raf. close (); 
catch (lOException e) 



} 

} 

} 

Because the RandomAccessFile constructor and EmployeeRecord's write () 
methods are capable of throwing FileNotFoundException and lOException 
objects, respectively, calls to those methods are placed in a Try statement. 
The associated Catch clause displays a message describing the exception (if 
it occurs) and a Finally clause performs cleanup, whether or not an excep- 
tion occurs. When CreateEmployeeFile completes, an employee.dat file exists 
and contains several employee records. 



NOTE 

It is common practice to close files in a Finally clause. That way, the file is closed 
(and all data waiting to be written to that file is flushed out to the file) whether or not 
an exception occurs. As you study Java source code, sometimes you will not see a call 
to a close ( ) method. The reason for the absence of close ( ) has to do with the under- 
lying platform automatically closing all files that are open at the time an application 



18 71710_CH15 11/21/01 4:20 PM Page 632 




632 Chapter 15: Files and Streams 



exists. Therefore, the call to raf. close () in the aforementioned CreateEmployeeFile 
application is not necessary. However, it is a good idea to get into the habit of explicitly 
closing open files. That is especially important if you create a program that runs for a 
long period of time and periodically opens a file. If that file is opened but not closed, 
you cannot open that file a second time, and your program fails. 



Now that a flat-file database consisting of employee . dat exists, the 
various records can be retrieved and their field values accessed. The 
UseEmployeeFile source code in Listing 15.5 shows how to accomplish those 
tasks. 

Listing 15.5: UseEmployeeFile . java. 
// UseEmployeeFile. java 

import java.io.*; 

class UseEmployeeFile 
{ 

public static void main (String [] args) 
{ 

EmployeeRecord blank = new EmployeeRecord (); 

RandomAccessFile raf = null; 

try 
{ 

raf = new RandomAccessFile ("employee.dat", "rw"); 

EmployeeRecord er = new EmployeeRecord (); 

int nunRecords = (int) raf. length () / er.size (); 

for {int i = 0; i < nunRecords; i++) 
{ 

er.read (raf); 

System. out. print (er.getFirstNane () + " "); 
System. out. print (er.getLastName () + " "); 
System. out. print (er.getAddress () + " "); 
System. out. print (er.getAge () + " "); 
System. out. println (er.getSalary ()); 

} 



System. out. println (""); 
raf. seek (0); 
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Listing 15.5: continued 

for (int i = 0; i < numRecords; i++) 



{ 



er.read (raf); 

if (er.getAge () >= 55) 
{ 

er.setSalary (0.0); 

raf. seek (raf .getFilePointer () 

er. write (raf); 

raf. seek (raf .getFilePointer () 
er.read (raf); 

} 



er.size ()); 
er.size ()); 



} 



System. out. print (er.getPirstNane () + " "); 
System. out. print (er.getLastName () + " "); 
System. out. print (er.getAddress () + " "); 
System. out. print (er.getAge () + " "); 
System. out. println (er.getSalary ()); 



} 

catch (lOException e) 
{ 

System. out. println (e.toString ()); 

} 

finally 
{ 

if (raf != null) 
try 

raf. close (); 
catch (lOException e) 



} 



} 



UseEmployeePile calls RandomAooessFile (String name, String mode) to open 
employee. dat for read and write access. It then creates an EmployeeRecord 
object (to hold each employee record that will be read from employee . 
dat) and divides the length of employee.dat (obtained by calling 
RandomAccessFile's length () method) by the size of an employee record 
(obtained by calling EmployeeRecord's size() method) to determine the 
number of fixed-length records that comprise employee.dat. When the 
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number of records is known, a For loop statement is used to iterate over all 
records. For each iteration, a record is retrieved, and its field values print 
in a tabular format. 

Notice the raf .seek (0) ; method call that follows the first For loop state- 
ment and the block of statements that For executes. That method call repo- 
sitions the file pointer to the start of employee . dat. Without raf . seek (0) ; , 
further attempts to retrieve records from employee . dat would result in 
EOFException objects being thrown. (EOFException is a subclass of 
lOException.) 

Following file pointer repositioning, a second For loop statement iterates over 
all records. Now, all records are examined to determine which employees are 
55 years of age or older Because those employees are considered to be retired 
(and are receiving pensions), their salaries must be reset to 0. (The employ- 
ees stay on because they have decided to volunteer their time to the company. 
If that sounds weird, keep in mind it is only an example.) If an employee 
record reveals that the employee's age is 55 or greater, the file pointer is 
backed up by one record, by calling raf . seek ( raf . getFilePointer ( ) 
- er.sizeO);, and the recently read Employee record, with the salary field 
set to 0, is written back to the file. One additional seek is required to back 
up the record so it can be reread, prior to printing. That reread is only pre- 
sent to prove that the data has been written out to the file. 

TIP 

Want to learn more about RandomAccessFile? Check out Sun's May 2000 TechTip, 
Random Access for Files (http : / / developer . j ava .sun.com/developer/TechTips/ 
2000/tt0509.html). Also, check out JavaWor/d's article Use a RandomAccessFile to 
Build a Low-Level Database (http: / /www. javaworld.com/iavaworld/iw-01 -1999/ 
iw-01 -step_p.html). 



Working with Streams 



A Java program uses a stream to either read data items from a source or to 
write data items to a destination. Think of a stream as a conduit by which a 
sequence of bytes flows from a source to specific program code or from spe- 
cific program code to a destination. That conduit can be likened to a wire on 
which an electrical current flows, or to a river of water on which boats and 
barrels float. Stream sources include files, memory buffers, network sock- 
ets, threads, and other streams. Stream destinations include the same enti- 
ties as stream sources, and other entities (such as printers). When a stream 
of data items flows from a source, that stream is referred to as an input 
stream. Similarly, when a stream of data items flows to a destination, that 
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stream is referred to as an output stream. Input and output streams are 
illustrated in Figure 15.3. 



Input Stream 





Output Stream 



Figure 15.3: Data items flow from a source to specific program code over 
an input stream and flow from specific program code to a destination over 
an output stream. 

Java divides streams into input and output categories. Java also divides 
streams into byte-oriented and character-oriented categories. The basic 
unit of a byte-oriented stream is a byte and the basic unit of a character- 
oriented stream is a Unicode character. 

All byte-oriented input streams are created from objects whose classes 
derive from the abstract Inputstream class, and all character-oriented input 
streams are created from objects whose classes derive from the abstract 
Reader class. Those classes share several methods in common, including 
a close ( ) method and a no-argument read ( ) method. Similarly, all byte- 
oriented output streams are created from objects whose classes derive from 
the abstract OutputStream class, and all character-oriented output streams 
are created from objects whose classes derive from the abstract writer 
class. As with the inputstream and Reader classes, OutputStream and Writer 
share methods in common (such as close ( ) and flush). Each class is located 
in the java.io package. 
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NOTE 

InputStream's and Reader's reacl( ) methods are designed to block (wait) for input if 
data is not available when either of those methods is called. InputStream declares an 
available ( ) method that can be called to return an integer identifying the number of 
bytes that can be read without blocking. Reader has no such method. 



An Inventory of Stream Classes 

Java's class library includes many stream classes. Rather than attempt to 
itemize every last stream class, this section focuses on a representative 
sample: file stream classes, buffered stream classes, data stream classes, 
piped stream classes, and Zip stream classes. 



File Stream Classes 

If you need to work with files in either a sequential-access or a random- 
access manner, you can use the RandomAccessFile class that was presented 
earlier in this chapter. However, the intent of the RandomAccessFile class is 
for its objects to manipulate record-oriented flat-file databases. If you are 
interested in reading an image's bytes, reading the contents of a text file, 
writing some configuration information to a file, and so forth, you would 
not use RandomAccessFile. Instead, you would work with various file stream 
classes: FilelnputStneam, FileReader, FileOutputStream, and FileWriter. 
(Those classes are located in the java.io package). 



TIP 

Use the FilelnputStream and FileOutputStream classes to read/write binary data 
from/to image files, sound files, video files, configuration files and so on. Also, those 
classes can be used to read/write ASCII-based text files. To read/write modern 
Unicode-based text files, use FileReader and FileWriter. 



EXAMPLE 



The file stream classes include constructors for creating input and output 
b3d;e-oriented or character-oriented streams that are connected to files 
opened or created by those constructors. If an input stream constructor can- 
not find a file to open for input, it will throw a FileNotFoundException object. 
Similarly, if an output stream constructor cannot create a file (because of 
bad path information, or for some other reason), it will throw an 
lOException object. 

Because of the various exceptions thrown by their constructors and meth- 
ods, the file stream classes might seem difficult to use. However, if you fol- 
low a pattern similar to the usage pattern that the Copy source code in 
Listing 15.6 demonstrates, you should not have trouble. 



/ 
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Listing 15.6: Copy. Java. 
// Copy.java 

import java.io.*; 

class Copy 
{ 

public static void main (String [] args) 
{ 

if (args. length != 2) 
{ 

System. out. println ("usage: java Copy srcpath dstpath"); 
return; 

} 

FilelnputStream fis = null; 
FileOutputStream fos = null; 

try 
{ 

fis = new FilelnputStream (args [0]); 
fos = new FileOutputStream (args [1]); 

int byte_; 

while {(byte_ = fis. read {)) != -1) 
fos. write (byte_); 

} 

catch (FileNotFoundException e) 
{ 

System. out. println ("File not found"); 

// Do other stuff related to that exception (if necessary). 

} 

catch (lOException e) 
{ 

System. out. println ("I/O Problem: " + e.getlUessage ()); 
// Do other stuff related to that exception (if necessary). 

} 

finally 
{ 

if (fis != null) 
try 
{ 

fis. close 0; 

} 
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Listing 15.6: continued 

catch (lOException e) 

{ 

} 

if (fos != null) 
try 
{ 

fos. close 0; 

} 

catch (lOException e) 

{ 

} 

} 

} 

} 

As its name suggests, Copy is an application that copies data from one file to 
another. Copy copies bytes from a file identified by a source path to a file 
identified by a destination path. For example, to copy all bytes contained in 
Copy.java to Copy.bak, issue the following command line: java Copy Copy, 
java Copy.bak. 

Notice the pattern that Copy's source code uses when working with files. 
First, because Copy is designed to copy byte-oriented streams instead of 
character-oriented streams. Copy declares a pair of FilelnputStneam and 
FileOutputStream reference variables, and initializes those variables to null. 
Within a Try statement. Copy attempts to create FilelnputStream 
and FileOutputStream objects. The FilelnputStream constructor throws 
a FileNotFoundException object if it cannot locate the source file and the 
FileOutputStream constructor throws an lOException object if it is given bad 
path information to a destination file. Assuming both constructors succeed, 
a While loop statement repeatedly calls FilelnputStream's read( ) method to 
read the next byte and FileOutputStream's write ( ) method to write that byte. 
The read( ) method continues to read bytes until end-of-file is encountered. 
At that time, read ( ) returns -1, and the loop ends. Regardless of whether or 
not an exception is thrown, the Finally clause executes last. By using If 
decision statements, it checks that FilelnputStream and FileOutputStream 
objects were created. If one or both of those objects was created, the object's 
close 0 method is called to close the underlying file. Because close () 
throws an lOException object if the underlying file is not open, it is neces- 
sary to place close ( ) method calls within their own Try statements. If you 
follow a pattern similar to what you have just read, you should not experi- 
ence trouble when working with the file stream classes. 
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TIP 

The FileOutputStream and FileWriter constructors typically erase existing files 
when creating files. However, it is possible to append bytes or characters to existing 
files by calling the FileOutputStream(String name, boolean append) and 
FileWriter(String name, boolean append) constructors, respectively, with true 
as the value of the append argument. 



Buffered Stream Classes 

Failing to buffer I/O operations is the leading cause of poor I/O perfor- 
mance. That is not surprising when you consider that disk drives efficiently 
read and write large aggregates of bytes but are not very efficient when it 
comes to reading and writing small byte aggregates. Because most of Java's 
stream classes do not buffer their read and write operations, stream objects 
are prone to poor I/O performance. 

170 performance can be radically improved by grouping individual bjd;es (or 
characters) into aggregates before performing a write operation or reading 
a large group of bytes (or characters) and returning those bytes (or charac- 
ters) on an individual basis from a buffer. That is the goal behind Java's 
Buf f eredlnputStream, Buf f eredReader, Buff eredOutputStream, and But f eredWniter 
classes. (Those classes are located in the java.io package.) 

Buff eredlnputStream and Buf f eredReader objects represent buffered input 
streams that are chained to other input streams so that bytes (or charac- 
ters) can flow from those other streams into buffered input streams. The 
following code fragment demonstrates that input stream chaining. 

FilelnputStrean fis = new FilelnputStream (pathname); 
Buff eredlnputStream bis = new Buf f eredlnputStream (fis); 
System. out. println (bis. read ()); 

The code fragment creates a FilelnputStream object and chains that 
object to a Buf feredlnputStream object, by passing the FilelnputStream 
object's reference to the Buff eredlnputStream constructor. The resulting 
Buff eredlnputStream object's reference assigns to bis. When bis. read () is 
called, that read( ) method checks an internal buffer (associated with the 
Buff eredlnputStream object assigned to bis) for at least one byte that can be 
returned. If a byte exists in that buffer, bis . read ( ) immediately returns. 
Otherwise, bis. read 0 internally calls fis. read (byte [] buffer, int offset, 
int length) to read a large chunk of bytes into the bis object's internal 
buffer. As long as bis . read ( ) does not have to call f is . read ( byte [ ] buffer , 
int offset, int length), performance is fast. When bis. read () must call 
fis. read(byte [] buffer, int offset, int length), performance slows down 
somewhat, because fis. read (byte [] buffer, int offset, int length) must 
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EXAMPLE 



access the disk drive. However, reading a large chunk of bytes via the 
f is. read (byte [] buffer, int offset, int length) method call is faster 
than performing many individual no-argument f is. read( ) method calls. 
Therefore, a bis . read ( ) method call is considerably faster than calls to 
fis.read(). 

NOTE 

To be fair, many platforms buffer data that is to be read from or written to a file. 
Therefore, the file stream classes do have some sort of buffering at their disposal. 
However, not all devices that support Java will buffer data at a platform level. Therefore, 
it is not a good idea to rely on such support. Instead, you should get into the habit of 
writing code that relies on the buffered stream classes. 

Buff eredOutputStream and Buf f eredWriter objects represent buffered output 
streams that are chained to other output streams so that bytes (or charac- 
ters) can flow from buffered output streams to those other streams. The fol- 
lowing code fragment demonstrates that output stream chaining. 
FileOutputStrean fos = new FileOutputStream (pathname); 
Buff eredOutputStream bos = new Buf f eredOutputStream (fos); 
bos. write ( 'A' ) ; 

The code fragment creates a FileOutputStream object and chains that object 
to a Buff eredOutputStream object, by passing the FileOutputStream object's 
reference to the Buff eredOutputStream constructor. The resulting 
Buff eredOutputStream object's reference assigns to bos. When bos. write 
( 'A' ) ; executes, that method call appends 'A' to the contents of an internal 
buffer (associated with the Buff eredOutputStream object assigned to bos). 
After that buffer fills, bos.writeO calls fos.write() to write the entire 
buffer to the disk. Because fewer (but larger) writes are made to a disk, 
performance improves. 

The Copy application in Listing 15.6 was not as efficient as it could have 
been. By adding support for buffering. Copy can become faster. Listing 15.7 
introduces a Buff eredCopy application that uses the Buff eredlnputStream and 
Buff eredOutputStream classes to support buffering. 

Listing 15.7: Buf feredCopy. Java. 
// BufferedCopy. java 

import java.io.*; 

class BufferedCopy 
{ 

public static void main (String [] args) 
{ 
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Listing 15.7: continued 

if (args. length != 2) 
{ 

System. out. println ("usage: java Buff eredCopy srcpath dstpath"); 
return; 

} 

Buff eredlnputStream bis = null; 
BufferedOutputStream bos = null; 

try 
{ 

FilelnputStream fis = new FilelnputStream (args [0]); 
bis = new Buff eredlnputStream (fis); 

FileOutputStream fos = new FileOutputStream (args [1]); 
bos = new BufferedOutputStream (fos); 

int byte_; 

while ((byte_ = bis. read ()) != -1) 
bos. write (byte_); 

} 

catch (FileNotFoundException e) 
{ 

System. out. println ("File not found"); 

// Do other stuff related to that exception (if necessary). 

} 

catch (lOException e) 
{ 

System. out. println ("I/O Problem: " + e.getMessage ()); 
// Do other stuff related to that exception (if necessary). 

} 

finally 
{ 

if (bis != null) 
try 
{ 

bis. close (); 

} 

catch (lOException e) 

{ 

} 



if (bos != null) 
try 
{ 
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Listing 15.7: continued 

bos. Close 0; 

} 

catch (lOException e) 

{ 

} 

} 

} 

} 

There is one interesting item to note about Buff eredCopy's source code: 
bis . close ( ) and bos . close ( ) appear instead of f is . close ( ) and f os . close ( ) . 
All of the stream classes thus far presented contain close ( ) methods. When 
you chain a buffered stream to a file stream, you might not know which 
close 0 method to call. The answer, as demonstrated by Buff eredCopy, is to 
call the close 0 method on the stream that chains itself to another stream. 
In Buff eredCopy, those methods are bis. close () and bos. close (). 



NOTE 

The Buf f eredlnputStream and Buf f eredReader classes support the capabilities of 
marl<ing a particular point in a stream and coming back to that point to reread a 
sequence of bytes (or characters). Those capabilities manifest by way of the mark{ ) 
and reset 0 methods. Use mark() to "remember" a point in the input stream and 
reset 0 to cause all bytes that have been read since the most recent mark operation 
to be reread, before new bytes are read from the stream to which the buffered input 
stream is chained. 

Because the mark() and reset () methods are declared in InputStream and Reader, 
you might think every class supports those methods. However, that is not the case. 
Although Buf f eredlnputStream and Buf f eredReader support mark() and reset(), 
many other input streams do not. Before calling those methods, find out whether an 
input stream supports mark { ) and reset ( ) , by calling the markSupported ( ) method. 
If an input stream supports the mark ( ) and reset { ) methods, markSupported ( ) 
returns true. 



Data Stream Guesses 

A problem with the FilelnputStream and FileOutputStream classes is that 
they only work at the byte level. What do you do when you need to read 
integers, write floating-point values, and read or write some other non-byte 
value from/to a file? The answer is to use Java's DatalnputStream and 
DataOutputStream classes (located in the java.io package portion of Java's 
standard class library). 

As with the buffered stream classes, the data stream classes are designed 
so that their objects can be chained to other streams. However, you can only 
chain data stream objects to bj^e-oriented streams. For example, you can 
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chain a data input stream to a FilelnputStream object and call the data 
input stream's methods to read integer, floating-point, and other data 
items, but you cannot directly chain a data input stream object to a 
FileReader object. 

For a glimpse of using DataOutputStream and DatalnputStream to write and 
read non-byte-oriented data items to and fi^om underlying FileOutputStream 
and FilelnputStream objects, examine the DOSDiSDemo source code in 
Listing 15.8. 

Listing 15.8: DOSDISDemo. java. 
// DOSDISDemo. java 

import java.io.*; 

class DOSDISDemo 
{ 

public static void main (String [] args) 
{ 

DataOutputStream dos = null; 

try 
{ 

FileOutputStream fos = new FileOutputStream { "data.dat" ) ; 
dos = new DataOutputStream (fos); 



dos.writelnt (256); 

dos .writeDouble (Math. PI); 

dos.writeUTF ("Java"); 



} 

catch (lOException e) 
{ 

System. out. println (e.getMessage ()); 
return; 

} 

finally 
{ 

if (dos != null) 
try 
{ 

dos. close 0; 

} 

catch (lOException e) 
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Listing 15.8: continued 

{ 
} 

} 



DatalnputStream dis = null; 



try 
{ 

FilelnputStream fis = new FilelnputStrean ( "data.dat" ) ; 
dis = new DatalnputStream (fis); 



System. out. println (dis.readint ()); 
System. out. println (dis . readDouble () 
System. out. println (dis.readUTF ()); 

} 

catch (lOException e) 
{ 

System. out. println (e.getlUessage ()); 
return; 

} 

finally 
{ 

if (dis != null) 
try 



dis. close (); 



catch (lOException e) 

} 

} 

} 

DOSDiSDemo introduces the UTF concept, by way of its writeUTF( ) and 
readUTF( ) method calls. UTF stands for Unicode Text Format, and it is an 
encoding format used for efficiently storing and retrieving text characters. 
According to the format used by Java, which is a slight variant of UTF-8: 

• All characters whose Unicode values range from \u0001 to \u007f are 
represented by a single byte, with the most significant bit set to 0. 

• The null character Unicode value (\uOOOO) and all characters whose 
Unicode values range from \u0080 to \u07ff are represented by two 
bytes, with the most significant three bits of the most significant byte 
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being 1, 1, and 0 (in a left-to-right order), and the most significant two 
bits of the least significant byte being 1 and 0 (in a left-to-right order). 

• All characters whose Unicode values range from \u0800 to \uffff are 
represented by three bytes, with the most significant four bits of the 
most significant byte being 1, 1, 1 and 0 (in a left-to-right order) and 
the most significant two bits of each of the remaining two bytes being 
1 and 0 (in a left-to-right order). 

When run, DOSDlSDemo produces the following output: 

256 

3.141592653589793 

Java 

NOTE 

Objects created from either the buffered stream or the data stream classes are known 
as filter streams. That name derives from their use in filtering bytes (or characters) that 
flow into a buffered input stream or filtering bytes that flow into a data input stream. 
Furthermore, that name derives from their use in filtering bytes (or characters) that flow 
out of the buffered output stream or filtering bytes that flow out of the data output 
stream. In addition to buffered and data stream classes, Java's standard class library 
includes other classes that are used to perform filtering operations. 



Piped Stream Classes 

Threads are often required to communicate. In a previous chapter, you 
learned about the use of shared variables to communicate data between 
threads. Another technique that is often used by threads wishing to com- 
municate involves piped streams. 

The idea behind piped streams is to connect a piped output stream to a 
piped input stream. Then, one thread writes data to the piped output stream 
and another thread reads that data by way of the piped input stream. 
Although there are no synchronization problems with piped streams, those 
streams have limited sizes. As a result, a writing thread could write more 
output to a piped output stream than that stream can accommodate, and the 
excess output would be lost. To prevent that from happening, the reading 
thread must be responsive. To support piped streams, Java supplies the 
PipedlnputStream, PipedReader, PipedOutputStream, and PipedWriter classes in 
its standard class library. (Those classes are located in the java.io package.) 



CAUTION 

Deadlock might occur if a single thread uses a piped output stream connected to a 
piped input stream and performs both writing and reading operations on that stream. 
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Creating a piped input stream connected to a piped output stream is not 
difficult, as the following code fragment attests: 

PipedWriter pw = new PipedWriter (); 
PipedReader pr = new PipedReader (pw); 

The code fragment first creates a piped output stream (as represented by 
the PipedWriter object) and then creates a piped input stream (as repre- 
sented by a PipedReader object) that binds itself to the piped output stream. 
When that's done, a writing thread can call pw. write () to output data to the 
piped output stream, whereas a reading thread can call pr. read() to read 
that output over its piped input stream. 

Listing 15.9 presents source code to a PipedThreads application that demon- 
strates one thread piping output to another thread, via piped streams. 

Listing 15.9: PipedThreads. Java. 
// PipedThreads. java 

import java.io.*; 

class MyThread extends Thread 
{ 

private PipedReader pr; 
private PipedWriter pw; 

MyThread (String name, PipedReader pr, PipedWriter pw) 
{ 

super (name); 

this.pr = pr; 
this.pw = pw; 

} 

public void run () 
{ 

try 
{ 

if (getName (). equals ("src")) 
{ 

for (int i = 0; i < 15; i++) 

pw. write ("src " + " A" + i + "\n"); // src writes 

pw. close 0; 

} 

else 
{ 
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int item; 

while ((item = pr.read ()) != -1) 

System. out. print ((char) item); // dst reads 

pr. close 0; 

} 

} 

catch (lOException e) 

{ 

} 

} 

} 



class PipedThreads 
{ 

public static void main (String [] args) throws lOException 
{ 

PipedWriter pw = new PipedWriter (); 
PipedReader pr = new PipedReader (pw); 



MyThread nt1 = new MyThread ("src", pr, pw) ; 
MyThread nt2 = new MyThread ("dst", pr, pw) ; 

mt1 . start ( ) ; 



OUTPUT 



ry 

Thread. sleep (2000); 
atch (InterruptedException e) 

mt2. start (); 



} 

When you run PipedThreads, you will see the following output: 

src A0 

src A1 

src A2 

src A3 

src A4 

src A5 

src A6 
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src A7 

src A8 

src A9 

src A10 

src A11 

src A12 

src A13 

src A14 



TIP 

For an additional example of piped streams, check out How to Use Pipe Streams In the 
Essential Java Classes trail of Sun's online Java Tutorial (http: / /j ava.sun.com/ 
docs/ books /tutorial/essential/io/pipedst reams . html). 



Zip Stream Classes 

Did you know that Java makes it easy to read and write Zip files? Zip sup- 
port manifests itself in the standard class library by way of the 
ZiplnputStream and ZipOutputStream filter stream classes, and other classes 
that (along with ZiplnputStream and ZipOutputStream) are part of the 
iava.util.zip package. By using those classes, it is possible to create a 
command-line version of the popular WinZip utility. 

To give you a taste for working with Zip stream classes. Listing 15.10 pre- 
sents source code to a ZipReader application. That application uses 
ZiplnputStream to retrieve all entries in a Zip file. For each entry, that 
entry's name prints. 

Listing 15.10: ZipReader. java. 
// ZipReader. java 

import java.io.*; 
import iava.util.zip.*; 

class ZipReader 
{ 

public static void main (String [] args) 
{ 

if (args . length != 1 ) 
{ 

System. out. println ("usage: java ZipReader pathname"); 
return; 

} 




EXAMPLE 



ZiplnputStream zis = null; 
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Listing 15.10: continued 
try 



{ 



FilelnputStream fis = new FilelnputStrean (args [O]); 
zis = new ZipInputStrean (fis); 



ZipEntry ze; 

while ((ze = zis.getNextEntry ()) != null) 
System. out. println (ze.getName ()); 

} 

catch (lOException e) 
{ 

System. out. println (e.getMessage ()); 

} 

finally 
{ 

try 

zis. close 0; 
catch (lOException e) 



} 



} 



To run ZipReader, you need access to either a Zip file or a Jar file (which is 
basically a Zip file with a . jar extension). For example, assuming the SDK's 
tools, jar file is placed in the same directory as ZipReader. class, issue java 
ZipReader tools . j ar to obtain a list of all packages and classes contained in 
that Jar file. 



TIP 

For another example of Zip file extraction, check out Sun's Unpacking Zip Files TechTIp 
(http: //developer. j ava. sun .com/ developer /TechTips/ 1998/ tt0421 . html). 



Standard I/O 

Before Graphical User Interfaces (GUIs) came into fashion, the command- 
line user interface reigned supreme. Although supplanted by modern GUIs, 
command-line user interfaces still exist. For evidence, consider the MS- 
DOS command window that is part of Microsoft Windows operating 
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systems. That command window offers a command-line user interface. Also, 
the Unix and Linux operating systems offer powerful command-line user 
interfaces. 

A mechanism supported by command-line user interfaces is known as stan- 
dard input and output (and error) — or standard I/O (for short). That mecha- 
nism still plays a useful role in modern GUI-based operating systems, 
where a developer often uses standard I/O to help find the cause of a failing 
program. Standard I/O consists of three devices (at the operating system 
level) that are regarded by Java as streams: standard input, standard out- 
put, and standard error. 

Standard Input 

An operating system controls the source of a program's standard input, by 
way of its standard input device. That device defaults to reading input from 
a device driver attached to a keyboard. However, it is possible to redirect 
(switch) the input source to a device driver that is attached to a file. As a 
result, standard input arrives from a file instead of the keyboard. 

A close look at Java's System class reveals an Inputstream class field named 
in. That field identifies an object whose methods, when called, obtain input 
from the standard input device. (Using Java terminology, it is common to 
say that input is arriving over the standard input stream.) Possibly, the 
most commonly called System . in method is System . in . read ( ) . That method 
takes no arguments and returns an integer. That integer is either a 7-bit 
ASCII key code (if the keyboard is the source of standard input) or an 8-bit 
byte (if standard input has been redirected to a file). System . in . read ( ) con- 
verts either the 7-bit ASCII code or the 8-bit byte to a 32-bit integer and 
returns the result. 

Consider the situation where System . in . read ( ) is used to read key codes 
from the keyboard. When a key is typed on a Windows-controlled keyboard, 
that key's 7-bit ASCII code is stored in an internal circular buffer — a queue. 
System . in . read () fetches the key code at the head of that queue and 
removes it from the queue (to make room for the next key code). System, 
in . read ( ) then converts that 7-bit ASCII key code to a 32-bit integer by 
prepending 25 zero bits to the key code. At that point, the key code returns 
from System . in . read () as a 32-bit integer. 

If there are no ASCII key codes in the queue. System . in . read ( ) waits for the 
user to type some keys followed by a terminator. That terminator is the 
Enter key (under Windows). Pressing Enter causes Windows to store a car- 
riage return key code (ASCII 13) followed by a newline key code (ASCII 10) 
in the queue. As a result, the queue can contain several non-terminator key 
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codes followed by a carriage return key code and a newline key code. The 
first of the queue's key codes returns (as an integer) from a call to System, 
in . read ( ). 

Many Java newcomers have the impression that System . in . read ( ) returns 
an arbitrary integer number (such as 25000 or -678). To prove to yourself 
that System . in . read ( ) returns only key codes or bytes, compile the 
EchoKeyCodes source code in Listing 15.11 and run the resulting program. 

Listing 15.11: EchoKeyCodes. java. 
// EchoKeyCodes . j ava 

class EchoKeyCodes 
{ 

public static void main (String [] args) throws java.io.IOException 
{ 

System. out. print ("Please type some keys and press Enter: "); 
int keyCode; 

while ((keyCode = System. in. read ()) != '\n') 
System. out. println ("Key code = " + keyCode + 

", Key = " + (char) keyCode); 

} 

} 

Run the program by issuing the following command line: java EchoKeyCodes. 
If you run EchoKeyCodes under Windows and type Test followed by the Enter 
key, you should see the following output: 

..^ ^ Please type some keys and press Enter: Test 
j^*j/B^ Key code = 84, Key = T 
^^-r^,\| Key code = 101, Key = e 

J Key code = 115, Key = s 

OUTPUT Key code = 116, Key = t 
Key code =13, Key = 

System . in . read ( ) does not throw an exception when reading from the key- 
board. However, it might throw an I/O exception when standard input is 
redirected to a file. The reason for throwing an I/O exception has to do with 
certain problems that can arise during a file read. For example, suppose 
EchoKeyCodes reads from a file located on a floppy disk instead of the key- 
board. Furthermore, suppose a user ejects the floppy disk during the file 
read. System. in. read ( ) must immediately stop its activity and report a prob- 
lem to its caller. Reporting takes place by throwing an lOException object. 
That is the reason for appending throws j ava . io . lOException to the main ( ) 
method's signature in EchoKeyCodes. 
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How is standard input redirected so input originates from a file? That task is 
accomplished by specifying a less-than sign character (<) followed by a path- 
name on the command line. For example, j ava EchoKeyCodes <EchoKeyCodes . 
Java causes EchoKeyCodes to receive input from EchoKeyCodes. j ava instead of 
the keyboard. Because each line in EchoKeyCodes.] ava ends in a newline 
character, only the first line in that source file appears when the previous 
command line is issued. 

EchoKeyCodes fails to display the entire contents of a source file because its 
While loop statement tests for a newline character that terminates the 
input. Although a newline character indicates no more key codes in a line 
of key codes stored in Windows' keyboard queue, it indicates only the end 
of one line in a text file. Therefore, you cannot use the newline character 
in a test for end-of-file. To test for end-of-file, you must compare System . in . 
readO's return value with -1. A-1 return value indicates end-of-file. The 
View application in Listing 15.12 tests against -1 so that it can output the 
entire contents of a text file. 

Listing 15.12: View, j ava. 
// View.] ava 

class View 
{ 

public static void main (String [] args) throws java.io.IOException 
{ 

int byte_; 

while ((byte_ = System. in. read ()) != -1) 
System. out. print ((char) byte_) ; 

} 

} 

To view the contents of view, j ava, issue the java View <View. java command 
line. The contents of that file appear on the standard output stream. 
However, if you fail to redirect View's input, you will find yourself in a situa- 
tion where you type a line of text, see that text displayed, type another line 
of text, see that text displayed and so on. The only way to exit that infinite 
loop is to press Ctrl+C (under Windows) or whatever key combination is 
appropriate for your platform. 

NOTE 

Because Java does not provide a way to determine whether standard input originates 
from the i<eyboard or a file, not knowing what System, in . read( ) return value to test 
against might seem disconcerting. However, you can write code to ensure that standard 
input originates from a specific stream source, by calling System's setln() method. For 
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example, FilelnputStream fis = new FilelnputStream (pathname); 
System. setin (fis) ; sets the standard input stream so that input always arrives 
from the file identified by pathname. 



Standard Output 

An operating system controls the destination of a program's standard out- 
put, by way of its standard output device. That device defaults to printing 
messages to a device driver attached to a command window's screen. With 
redirection, the output destination can be redirected to a file or printer, so a 
program's standard output can be saved to external storage or printed on 
paper. 

A close investigation of Java's System class reveals a PnintStream class field 
named out. That field identifies an object whose methods, when called, send 
output to the standard output device. (Using Java terminology, it is com- 
mon to say that output is leaving over the standard output stream.) 
PrintSt ream's printing methods divide into two categories. The "print" meth- 
ods output data not followed by newline characters. In contrast, the 
"println" methods output newline characters after everything else. 

NOTE 

Neither PrintStream's nor PrinterWriter's various printing methods throw exceptions 
to indicate errors. To determine whether an error has occurred, call either class's 
checkErrorO method. That method returns a Boolean true value if an error occurred 
during a print operation. Furthermore, that method flushes the contents of a print 
stream to its destination. If all you want to accomplish is flush a print stream to its 
destination (without closing the stream), call that stream's f lush ( ) method. 

Because of the wide use of standard output throughout this book, I will not 
bore you with another example. However, keep in mind that you can redi- 
rect standard output to a specific file or printer by specifying a greater-than 
sign character (>) followed by a pathname on the command line. To con- 
tinue the earlier view example, java View <View.iava >out copies the con- 
tents of View, java to a file named out, instead of displaying View. Java's 
contents on the command window's screen. 

NOTE 

You can write code to ensure that standard output always ends up at a specific stream 
destination, by calling System's setOutO method. For example, FileOutputStream 
fos = new FileOutputStream (pathname); System . setOut (fos); sets the stan- 
dard output stream so that output always travels to the file identified by pathname. 
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As with standard input and standard output, an operating system supports 
the concept of a standard error device. The standard error device is that 
part of an operating system that establishes the destination of a program's 
error messages. Unhke the standard output device, platforms such as 
Windows 98 do not allow the standard error device's destination to be redi- 
rected. As a result, messages sent to standard error appear on a command 
window's screen. (Other operating systems, such as Unix or Linux, allow 
standard error to be redirected.) 

Java's System class rounds out its in and out class fields with an err class 
field (of type PrintStream). That field identifies an object whose methods, 
when called, send error output to the standard error device. (Using Java 
terminology, it is common to say that error output is leaving over the stan- 
dard error stream.) 

When writing small command-line user interface-type utilities, it is com- 
mon to check for the number of command-line arguments passed to that 
utility. If an invalid number of arguments have been passed, the utility typ- 
ically displays an error message and exits. Although that message can be 
output to the standard output stream, it is typically better to output that 
message to the standard error stream. Because standard output can be 
redirected, error messages might not be readily available to that program's 
user. Assuming that standard error is "hard-wired" to the screen, those 
messages are available and confusion is minimized. The following code 
fragment demonstrates that, 
public static void main (String [] args) 
{ 

if (args. length != 2) 
{ 

System. err. println ("usage: Java Copy srcpathi dstpath2"); 
return; 

} 

} 

The code fragment assumes that it is part of a Copy application. If the user 
does not specify a source pathname and a destination pathname (and no 
other command-line arguments), that code fragment sends an error mes- 
sage to the standard error stream. 



NOTE 

For platforms that support standard error redirection, you can write code to ensure that 
standard error always ends up at a specific stream destination, by calling System's 
setErrO method. For example, FileOutputStream fos = new FileOutputStream 
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(pathname); System. setErr (fos); sets the standard output stream so that output 
always travels to the file identified by pathname. 



Processes 

Developers occasionally need to write applications that run other programs. 
For example, consider writing a Java application that runs a Web browser. 
How do you accomplish that task? Fortunately, Java supports the concept of 
running "external" programs by providing several overloaded exec ( ) meth- 
ods in its Runtime class and by providing a Process class that manages run- 
ning programs. 

The simplest exec( ) method takes a single Str'ing argument that names a 
program to be run and provides a sequence of arguments to that program. 
Those arguments customize the program's execution. For example, you 
might specify the name of a word-processor program followed by a filename 
argument, so that the word-processor program begins with a loaded docu- 
ment, as specified by that filename. If any exec ( ) method fails to run a 
specified program, it throws an lOException object. Otherwise, exec() 
returns a reference to a Process object, whose methods can be called to con- 
trol the process (that is, the running program). Those methods are 
described in Table 15.3. 

Table 15.3: Process Methods 



Method 



Description 



void destroy {) 
int exitValueO 

InputStream getErrorStream ( ) 



InputStream getlnputStream ( 



Kill the process associated with the current Process 
object. 

Return the exit value of the process associated with 
the current Process object. By convention, zero indi- 
cates normal termination. If the process has not yet 
terminated, an IllegalThreadStateException object 
is thrown. 

Return an input stream that connects to the stan- 
dard error stream of the process associated with the 
current Process object. Data arriving on the input 
stream originated on the process's standard error 
stream. It is not a good idea for the input stream to 
be buffered. 

Return an input stream that connects to the stan- 
dard output stream of the process associated with 
the current Process object. Data arriving on the 
input stream originated on the process's standard 
output stream. It is not a good idea for the input 
stream to be buffered. 
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Table 15.3: continued 




EXAMPLE 



Method 



Description 



OutputStream getOutputStream{ ) 



int waitFor( 



Return an output stream that connects to the stan- 
dard input stream of the process associated with 
the current Process object. Data sent to the output 
stream arrives on the process's standard input 
stream. It is not a good idea for the output stream 
to be buffered. 

Force the current thread to wait until the process 
associated with the current Process object has ter- 
minated. If that process has terminated, waitFor() 
immediately returns. In either case, waitFor() 
returns that process's exit value. Also, waitForO 
throws an InterruptedException object if its waiting 
thread is interrupted by another thread. 

For your first taste of running an "external" program, check out Listing 
15.13. That fisting presents source code to a Runi appfication that runs a 
program, by way of an exec ( ) method, and then uses the returned reference 
to a Process object, describing the process, to wait until the process com- 
pletes. 

Listing 15.13: Run1 . java. 
// Run1 .java 



import java.io.*; 



class Run1 
{ 

public static void main (String [] args) throws java.io.IOException 
{ 

if (args . length != 1 ) 
{ 

System. err. println ("usage: java Run pathname"); 
return; 

} 



Process p = Runtime. getRuntime ().exec (args [0]); 



try 
{ 

System. out. println ("Exit status = " + p.waitFor ()); 

} 
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Listing 15.13: continued 

catch (InterruptedException e) 
{ 
} 

} 

} 

Despite its power, Runl does not require much source code. All it does is run 
a program and wait for that program to complete. You can run many kinds 
of programs with Runl. For example, to run the Windows notepad.exe pro- 
gram, issue the following command line: Java Run notepad. When you exit 
notepad.exe, Runl will display notepad. exe's exit status. 

Each running program is known as a process. When a program runs 
another program, the program that runs the other program is known as a 
parent process, and the other program is known as a child process. The 
child process is dependent on the parent process for such things as a con- 
sole window. As a result, a child process has no independent standard error, 
standard output, and standard input streams. If a child process needs 
access to either stream, the parent process must make allowance, by setting 
up those streams. The parent process sets up the standard error, standard 
output, and standard input streams for the child process by calling the 
Process class's getErrorStream( ), getOutputStream( ), and getlnputStream ( ) 
methods, respectively. 

Listing 15.14 presents source code to a Run2 application. That application is 
similar to Runl except for setting up a child process's standard output 
stream, so that the child process's output can be read by the parent process 
EXAMPLE then sent to the parent process's standard output stream. 

Listing 15.14: Run2. java. 
// Run2.iava 

import iava.io.*; 

class Run2 
{ 

public static void main (String [] args) throws java.io.IOException 
{ 

if (args. length != 1 ) 
{ 

System. err. println ("usage: java Run pathname"); 
return; 

} 
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Listing 15.14: continued 

Process p = Runtime. getRuntime ().exec (args [0]); 

// Read all information that the child process sends to its standard 
// output stream and send the read information to the parent process's 
// standard output stream. 

InputStream is = p.getlnputStream (); 
int b; 

while ( (b = is. read ( ) ) != -1 ) 
System. out. print ((char) b); 

try 

System. out. println ("Exit status = " + p.waitFor ()); 
catch (InterruptedException e) 

} 

} 

Run2 captures a child process's standard output stream by calling 
getlnputStream( ) and by repeatedly calling that stream's read() method to 
retrieve each byte (which subsequently prints to the parent's standard out- 
put stream) until there are no more bytes. Although Run2 takes care of stan- 
dard output, there are still the standard error and standard input streams 
to consider. Because Run2 does not set up those streams, the following situa- 
tions can occur: 

• If the child process sends output to the standard error stream, that 
output is never displayed. 

• If the child process requires input from the standard input stream, the 
child process blocks (waits). 

The standard error stream problem can be easily fixed by placing the fol- 
lowing code fragment after the code fragment that sends the child process's 
standard output stream contents to the parent process's standard output 
stream: 

is = p.getErrorStream (); 
int b; 

while ((b = is. read ()) != -1) 
System. err. print ((char) b); 

There is an implication to that fix. If the parent's standard output and 
standard error streams refer to the console, all bytes sent by the child 
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process to its standard output stream are displayed before any of the bytes 
that the child process sent to its standard error stream. It is probably best 
to follow that approach because a child process that uses standard I/O typi- 
cally outputs more bytes to the standard output stream than to the stan- 
dard error stream, and it is possible to lose bytes sent to the standard 
output stream on those platforms that provide a limited buffer size for the 
standard output stream. 

The standard input stream problem is not as easy to fix. Assuming that the 
child process reads bytes from its standard input stream, it must receive 
those bytes or it blocks — and could even deadlock. It would appear that 
bytes must be sent to the child process's standard input stream while bytes 
are being read from its standard output stream. That activity can become 
quite complicated. A better technique involves the use of a thread that is 
dedicated to "feeding" data bytes to the child process. 



CAUTION 

Runtime's exec( ) methods do not work well for certain kinds of processes on certain 
native platforms. Those processes include native windowing processes, daemon 
processes, Winl6/D0S processes on 32-bit versions of Microsoft Windows, and Unix 
shell scripts. To learn more about the exec() methods and some of their problems, 
check out JavaWorld's When Runtime.exec() Won't article (http: //www. j avaworld . 
com/ ] w- 12 -2000/ jw- 1229 -traps, html). 



Object Serialization 



Imagine the following scenario. You are interacting with a Java program on 
your laptop computer. All of a sudden, your computer's low-battery-indicator 
light comes on. Your Java program detects that condition, saves the state of 
its objects to some kind of permanent memory, and shuts down. Shortly 
thereafter, the computer shuts down. You plug your computer into a 
recharging device and leave it alone for a few hours. Later, you come back 
and turn on the computer. The computer returns to "life," and the Java pro- 
gram that was "frozen in its tracks" automatically picks up from where it 
left off. No data has been lost. Science fiction? No. The capabilities of saving 
objects' state and recovering that state (and reconstituting objects with that 
state) at a later point in time are known as object serialization and object 
deserialization, respectively. 

The serialization mechanism converts the contents of objects into a stream 
of bytes that can be written to a file or transmitted across a network to 
some destination. To support serialization, Java provides a Serializable 
interface (in the java.io package) and an ObjectOutputStream class (also in 
the java.io package). The Serializable interface is empty: It contains no 
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methods. The purpose of Serializable is to tag classes that support serial- 
ization. Only objects created from such classes (and subclasses) can be seri- 
alized. To perform the actual serialization task, a call must be made to 
ObjectOutputStream's writeObiect( ) method, with a reference to the object 
that must be serialized as writeObiect( )'s sole argument. That method 
writes that object's instance field values to an object output stream along 
with metadata (such as the object's class name, whether or not the class is 
public and/or abstract, field names, field types, and so on). If any of the 
object's fields are reference fields, wniteObject() recursively writes meta- 
data (along with recursively obtained primitive field values) for each object 
referenced by each reference field. If contained objects contain reference 
fields, the same thing happens to the objects referenced by those fields. 

CAUTION 

Use care when calling writeOb]ect{ ) . If a problem is discovered with an object's class 
during serialization (such as the class's field types being modified after a class file was 
created), writeObject( ) throws an InvalidClassException object. If the object's 
class (or the class of one of the object's contained objects) does not implement 
Serializable, writeObjectO throws a NotSerializableException object. Finally, 
writeObiect( ) throws an lOException object if it is unable to write to the underlying 
output stream. 

The deserialization mechanism recreates an object from its saved state. It 
uses the metadata saved with field values to discern class structure. 
Because methods are not saved, the object's class file must exist and be 
accessible during deserialization. To support deserialization, Java provides 
an ObjectlnputStream class (located in the java.io package). A call to 
ObjectlnputStream's readObject() method reconstitutes a serialized object 
and returns a reference to that object. 

CAUTION 

Use care when calling readObj act ( ) . If readObj ect ( ) cannot locate the class file (by 
way of the JVM) that corresponds to the metadata in a serialized object, that method 
throws a ClassNotFoundException object. An InvalidClassException object is 
thrown if there is something wrong with the serialized object's class (such as the serial- 
ized object referring to a type that does not match any type in a found class file). A 
StreamCorruptedException object is thrown when metadata read from the serialized 
object does not match internal consistency checks. If unexpected data (such as primi- 
tive data) is found instead of serialized objects in an input stream, readObj ect ( ) 
throws an OptionalDataException object. Finally, readObj ect () throws an 
lOException object if it is unable to read the underlying input stream. 



Default Serialization and Deserialization 

Java's serialization and deserialization mechanisms were designed for easy 
use. The simplest way to perform serialization and deserialization is to use 
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the default implementations. Those implementations require that either 
the class or superclass of an object (and each contained object) being serial- 
ized implement the Serializable interface. Furthermore, they require the 
creation of an ObjectOutputStream object chained to a destination stream, a 
call to its writeOb] ect ( ) method to serialize that object, the creation of an 
ObjectlnputStream object chained to a source stream when it comes time to 
recover an object, and a call to its readObjectO method to deserialize that 
object. 

\ I / For a first exposure to serialization and deserialization, take a look at 
^1 Listing 15.15's source code to the SDDemoi application. That code uses the 
default serialization and deserialization mechanism. 



EXAMPLE 



Listing 15.15: SDDemoi .Java. 
// SDDemoi . java 

import java.io.*; 

class Engine implements Serializable 
{ 

private int numCylinders; 

Engine (int numCylinders) 
{ 

this. numCylinders = numCylinders; 

} 

int getNumCylinders () 
{ 

return numCylinders; 

} 

} 

class Car implements Serializable 
{ 

private int numTires; 
private Engine e; 
private String name; 

Car (String name, int numTires, Engine e) 
{ 

this. name = name; 

this. numTires = numTires; 

this.e = e; 

} 
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Listing 15.15: continued 
int getNumTires () 

return nunTires; 



Engine getEngine () 
return e; 



String getNane () 
return name; 

} 

class SDDenol 
{ 

public static void main (String [] args) 
{ 

Car c1 = new Car ("Some car", 4, new Engine (6)); 

ObjectOutputStream oos = null; 

try 
{ 

FileOutputStream fos = new FileOutputStream ("car.ser"); 
oos = new ObjectOutputStream (fos); 

oos.writeObject (c1); 

} 

catch (Exception e) 
{ 

System. out. println ; 
return; 

} 

finally 
{ 

if (oos != null) 
try 
{ 

oos. close 0; 

} 

catch (lOException e) 
{ 
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Listing 15.15: continued 
} 

} 

ObjectlnputStream ois = null; 



try 
{ 



FilelnputStream fis = new FilelnputStream {"car. sen"); 
ois = new ObjectlnputStream (fis); 

Car c2 = (Car) cis . readObj ect (); 



System. out. println ("Number of tires = " + c2.getNumTires () 
System. out. println ("Number of cylinders = " + 

c2.getEngine ( ) .getNumCylinders ()); 
System. out. println ("Name = " + c2.getName {)); 

} 

catch (Exception e) 
{ 

System. out. println ; 

} 

finally 
{ 

if (ois != null) 
try 

ois. close 0; 
catch (lOException e) 



} 



} 



SDDemol demonstrates default serialization and deserialization. Both a Gar 
object and its contained Engine and String objects are serialized and deseri- 
alized. To make that happen, Engine and Car implement Serializable. 
(String and many other standard class library classes also implement 
Serializable.) Then, the main() method performs serialization by creating 
an ObjectOutputStream object chained to a FileOutputStream object and by 
calling the writeObj ect ( ) method with a reference to a Car object. The 
serialized Car and contained objects are stored in a file named car.ser. 
Later, the main ( ) method performs deserialization by creating an 
ObjectlnputStream object chained to a FilelnputStream object and by calling 
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the readObiect( ) method to return a reference to the deserialized Car object 
(and its contained Engine and String objects). If you run SDDemol, you will 
see the following output: 

Number of tires = 4 
Number of cylinders = 6 
Name = Some car 




OUTPUT By default, the writeObiect( ) method writes every instance field value to an 
object output stream. Sometimes, it is not desirable for writeObject( ) to 
write certain instance field values. For example, it would probably not be 
appropriate to serialize an object's password field value. After all, someone 
might intercept the object in transit to its destination and obtain the pass- 
word. Also, there is no point in serializing a Thread object, because that 
object is tied to resources that are specific to the current invocation of a 
JVM. If a class declares a field whose value should not be written out by 
writeObiect( ), that field should be declared using the transient keyword 
modifier. 

Another example of where you should consider using transient is a counter 
instance field. For example, suppose you create your own Timer class (which 
is what developers had to do prior to the SDK 1.3 introduction of a stan- 
dardized Timer class). If you serialize a Timer object, should the counter field 
value be saved? The answer is no. A timer starts counting from zero. If you 
save the counter value and reconstruct the Timer object at some future point 
in time, the timer will start counting from where it left off. To demonstrate. 
Listing 15.16's SDDemo2 source code includes a Timer class with a pair of 
transient instance fields. 

Listing 15.16: SDDemo2. java. 
// SDDemo2.iava 

import java.io.*; 

class Timer extends Thread implements Serializable 
{ 

private String name; 



EXAMPLE 



private transient long counter; 
private transient boolean stopped; 

Timer (String name) 
{ 

this. name = name; 

} 
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Listing 15.16: continued 
public void run () 
{ 

long tine = System. currentTineMillis (); 

while (! stopped) 
{ 

try 
{ 

// Sleep for exactly 10 milliseconds. 



tine += 10; 



Thread. sleep (Math. max (0, 

time - System. currentTimeMillis ())); 

} 

catch (InterruptedException e) 

{ 

} 

// Do not change the counter while its value is being incremented. 
// Many JVMs require two 32-bit operations when accessing a 64-bit 
// long integer. 



synchronized (this) 
{ 

counter-^-^; 

} 

} 

} 



void begin () 
{ 

stopped = false; 
start 0; 

} 

void end () 
{ 

stopped = true; 

} 



synchronized long getCounter () 
{ 

return counter; 

} 
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Listing 15.16: continued 
String getTinerName () 
{ 

return name; 

} 

} 

class SDDemo2 
{ 

public static void main (String [] args) 
{ 

// Create and begin a timer. 

Timer t1 = new Timer ("Timer A"); 
t1. begin (); 

// Sleep for awhile to give the timer a chance to increment the 
// counter several times. 

try 
{ 

Thread. sleep (2000); 

} 

catch ( InterruptedException e) 

{ 

} 

// End the timer. 
t1 .end {); 

// Print out the current Timer name and counter. 

System. out. println ("Timer name = " + t1 .getTimerName ()); 
System. out. println ("Timer counter = " + t1 .getCounter ()); 

// Serialize the Timer object. 

ObjectOutputStream cos = null; 

try 
{ 

FileOutputStream fos = new FileOutputStream ( "timer. ser" ) ; 
COS = new ObjectOutputStream (fos); 
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Listing 15.16: continued 

oos.writeObject (t1); 

} 

catch (Exception e) 
{ 

System. out. println ; 
return; 

} 

finally 
{ 

if (COS != null) 
try 

oos. close 0; 
catch (lOException e) 



} 

// Deserialize the Timer object. 

ObjectlnputStream ois = null; 

try 
{ 

FilelnputStream fis = new FilelnputStream { "timer. ser" ) ; 
ois = new ObjectlnputStream (fis); 

Timer t2 = (Timer) ois. readObject (); 

// Print deserialized Timer name and counter. 

System. out. println ("Timer name = " + t2.getTimerName ()); 
System. out. println ("Timer counter = " + t2.getCounter ()); 

// Begin the timer. 

t2. begin (); 

// Print out some counter values. 

for (int i = 0; i < 10; i++) 
{ 

System. out. println (t2.getCounter ()); 
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Listing 15.16: continued 

// Sleep for awhile. 

ry 

Thread. sleep (100); 
catch (InterruptedException e) 

} 

// End the timer. 
t2.end 0; 

} 

catch (Exception e) 
{ 

System. out. println ; 

} 

finally 
{ 

if (ois != null) 
try 

ois. close 0; 
catch (lOException e) 



} 

A close look at SDDemo2's Timer class reveals a non-transient name field and a 
pair of transient counter and stopped fields. The name field is not marked 
transient because it is desirable to recover the timer's name when a serial- 
ized Timer object is deserialized. However, it is not desirable to start count- 
ing from the last value stored in the counter field. Therefore, that field is 
marked transient. But should stopped also be marked transient? After all, a 
non-transient stopped field introduces no problems into the example. 
Because stopped defaults to false and ends up with a true value when end( ) 
is called, assigning true to stopped during the deserialization of a Timer 
object could cause a problem if stopped is non-transient and the architec- 
ture of the Timer class should ever change. If you do not have Timer's source 
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code to fix that problem (by marking stopped transient), you have a big 
problem on your hands when deserializing a Timer object. 

TIP 

It is customary to attach a . ser extension to tine filename of a file that contains a seri- 
alized object. 



Custom Serialization and Deserialization 

On occasion, you might want to control the manner in which an object is 
serialized and/or deserialized. For example, you might want to encrypt field 
values as they are serialized and decrypt those values when deserialized. To 
customize the serialization and deserialization mechanisms, you need to 
implement the following methods: 

private void writeObjectlObiectOutputStream oos) 
throws lOException 

private void readObjectlObiectlnputStream ois) 

throws lOException, ClassNotFoundException 

The writeObiect(ObiectOutputStream oos) method is called by way of 
ObjectOutputStream's writeOb]ect(Object o) method when that method 
detects that an object declares the private writeObiect(ObjectOutputStream 
oos) method. Similarly, the readObiect(ObjectlnputStrearti ois) method is 
called by way of ObjectlnputStream's readObjectO method when that method 
detects that an object declares the private readObiect(ObiectlnputStream 
ois) method. 

The writeObjectCObiectOutputStream oos) method can call 
oos.defaultWriteObjectO to write the values of all non-transient and 
non-static fields after making whatever changes are necessary to the values 
in those fields. Similarly, the readObiectCObjectlnputStream ois) method can 
call ois.defaultReadObjectO to read values into all non-transient and non- 
static fields prior to making changes to the just-read field values. 

Customizing the serialization and deserialization mechanisms is not diffi- 
cult. For proof, examine the SDDemo3 source code from Listing 15.17. 

Listing 15.17: SDDemo3 . j ava. 
// SDDemoS.java 

import java.io.*; 




EXAMPLE 



class Employee implements Serializable 
{ 
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Listing 15.17: continued 

private String name; 
private double salary; 

Employee (String name, double salary) 
{ 

this. name = name; 
this. salary = salary; 

} 

String getNane () 
{ 

return name; 

} 

double getSalary () 
{ 

return salary; 

} 

private void writeObject (ObjectOutputStrean oos) throws lOException 
{ 

oos.defaultWriteObject (); 

System. out. println ("Serializing Employee ob]ect\n"); 

} 

private void readObject (ObiectlnputStream ois) throws Exception 
{ 

ois.defaultReadObject (); 
salary += 100; 

System. out. println ("Deserializing Employee object"); 

} 

} 

class SDDemoS 
{ 

public static void main (String [] args) 
{ 

Employee e1 = new Employee ("John Doe", 45000.0); 

System. out. println (e1. getNane () + " " + e1. getSalary ()); 

ObjectOutputStream oos = null; 



try 
{ 
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Listing 15.17: continued 

FileOutputStream fos = new FileOutputStream ( "employee . ser" ) ; 
oos = new ObjectOutputStream (fos); 

oos.writeObject (e1); 

} 

catch (Exception e) 
{ 

System. out. println ; 
return; 

} 

finally 
{ 

if (oos != null) 
try 

oos. close 0; 
catch (lOException e) 



} 

ObjectlnputStream ois = null; 

try 
{ 

FilelnputStream fis = new FilelnputStream ( "employee. ser" ) ; 
ois = new ObjectlnputStream (fis); 

Employee e2 = (Employee) ois. readObject (); 

System. out. println (e2.getName () + " " + e2.getSalary ()); 

} 

catch (Exception e) 
{ 

System. out. println ; 

} 

finally 
{ 

if (ois != null) 
try 
{ 

ois. close 0; 

} 
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Listing 15.17: continued 

catch (lOException e) 

{ 

} 



} 

} 

SDDemo3 implements the writeObject (Ob jectOutputStream oos) and 
readObiect(ObjectlnputStream ois) methods to demonstrate that those 
methods are called. It does that by printing appropriate messages. 
Furthermore, readOb]ect(ObjectlnputStream ois) updates the salary field in 
the Employee class by adding 100 to that field's value. When run, SDDemoS 
outputs the following data: 

John Doe 45000.0 
Serializing Employee object 



Deserializing Employee object 

"'^''''''J''' John Doe 45100.0 



TIP 

For more advanced information on default and custom serialization and deserialization 
(including a discussion of a special hybrid constant/read-write variable known as 
serialVersionUID), check out Sun's Serialization in tlie Reai World TechTip 
(http: / /developer. iava.sun.com/cleveloper/TechTips/2000/tt0229.html). 



Externalization 

A discussion of object serialization is not complete without a look at exter- 
nalization. Unlike regular serialization and deserialization, externalization 
gives you complete control over the serialization and deserialization tasks. 
That is accomplished by having the class implement the Externalizable 
interface (in the j ava . io package). Implementing that interface implies that 
the class declare the following two methods: 

public void writeExternal(ObjectOutput out) 
throws lOException 

public void readExternal(ObjectInput in) 

throws lOException, ClassNotFoundException 

Objects created from classes that implement Externalizable (or subclasses 
of those classes) assume complete responsibility for writing their states to 
an object output stream. Furthermore, Ob jectOutputStream does not assume 
the responsibility of writing metadata (beyond a class name) for each 
object. 
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^ \ I / For an idea of how to use writeExternal( ) and reaclExternal( ), check out the 
1 vIB^ EDemo source code from Listing 15.18. 

Listing 15.18: EDemo. java. 
// EDemo. java 

import java.io.*; 

class Engine implements Externalizable 
{ 

private int numCylinders; 

public Engine () 
{ 
} 

Engine (int numCylinders) 
{ 

this. numCylinders = numCylinders; 

} 

int getNumCylinders () 
{ 

return numCylinders; 

} 

public void readExternal (Objectlnput in) 

throws lOException, ClassCastException 

{ 

System. out. println ( "READ-Engine" ) ; 
numCylinders = in.readint {); 

} 

public void writeExternal (ObjectOutput out) 
throws lOException 

{ 

System. out. println ( "WRITE-Engine" ) ; 
out.writeint (numCylinders); 

} 

} 

class Car implements Externalizable 
{ 

private int numTires; 
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Listing 15.18: continued 

private Engine e; 
private String name; 

public Car () 



Car (String name, int numTires, Engine e) 

this. name = name; 

this. numTires = numTires; 

this.e = e; 

int getNumTires () 
return numTires; 

Engine getEngine () 
return e; 

String getName () 
return name; 

public void readExternal (Objectlnput in) 

throws lOException, ClassCastException 

{ 

System. out . print In ( "READ -Car" ) ; 

numTires = in.readint (); 
name = in . readUTF ( ) ; 

try 

e = (Engine) in.readObject (); 
catch (ClassNotFoundException e) 



} 
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Listing 15.18: continued 

public void writeExternal (ObjectOutput out) 
throws lOException 

{ 

System. out. print In ( "WRITE -Car" ) ; 

out.writeint (numTires); 
out.writeUTF (name); 
out.writeObject ; 

} 

} 

class EDemo 
{ 

public static void main (String [] args) 
{ 

Car c1 = new Car ("Some car", 4, new Engine (6)); 

ObjectOutputStream oos = null; 

try 
{ 

FileOutputStream fos = new FileOutputStream ("car.ser"); 
oos = new ObjectOutputStream (fos); 

oos.writeObject (c1); 

} 

catch (Exception e) 
{ 

System. out. println ; 
return; 

} 

finally 
{ 

if (oos != null) 
try 

oos. close 0; 
catch (lOException e) 



} 

ObjectlnputStream ois = null; 
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Listing 15.18: continued 
try 
{ 



FilelnputStream fis = new FilelnputStrean ("car. sen"); 
ois = new ObjectlnputStream (fis); 

Car c2 = (Car) ois . readObj ect (); 

System. out. println ("Number of tires = " + c2.getNuniTires ()); 
System. out. println ("Number of cylinders = " + 

c2.getEngine ( ) .getNumCylinders ()); 
System. out. println ("Name = " + c2.getName ()); 

} 

catch (Exception e) 
{ 

System. out. println ; 

} 

finally 
{ 

if (ois != null) 
try 

ois. close 0; 
catch (lOException e) 



OUTPUT 



} 

When run, EDemo produces the following output: 

WRITE-Car 

WRITE-Engine 

READ-Car 

READ-Engine 

Number of tires = 4 

Number of cylinders = 6 

Name = Some car 

To perform externalization, EDemo uses the ObjectOutputStream and 
ObjectlnputStream classes (and readObjectO and writeObiect( ) methods) 
that have previously been used. However, each participating class in the 
externalization process is required to declare a public no-argument con- 
structor and must implement the Externalizable interface by declaring 
writeExternalO and readExternal() methods. Because those methods take 
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ObjectOutput and Objectlnput arguments, respectively, a variety of methods 
can be called to output and input field values of different types. 

Because the writeExternal( ) and readExternal( ) methods are public meth- 
ods, they carry the risk that another object might be able to write informa- 
tion to or read information from the object whose class implements those 
methods. Do not use either method if the information held in an object rep- 
resents a security risk. 



TIP 

Although it requires more work than serialization (which can lead to bugs if you are 
not careful), externa lization offers improved performance. To learn more about such 
performance, check out Sun's TechTIp Improving Serialization Performance with 
Externalizable (http://cleveloper.iava. sun. com /developer/TechTips/ 2000/ 
tt0425.html). 



Stream Tokenizers 



Certain kinds of programs (such as a text-based adventure game or a com- 
piler) need to figure out the meaning of human-entered text. The first step 
in that task is to parse the text into a sequence of tokens. In Chapter 12, 
you learned about the StringTokenizer class, and its capability of returning 
tokens from a string-based text source. Because that class is only useful for 
simple tokenizing operations where the text source is a string, you need to 
consider the StreamTokenizer class (located in the java.io package) for more 
complex tokenizing tasks. 



TIP 

For simple tokenizing tasks, where the text source is a string, use StringTokenizer. If 
the tokenizing task is somewhat more complex and/or the text source is not a string, 
use StreamTokenizer. 



A StreamTokenizer object reads characters from an input stream and regards 
each character as having a value in the Unicode range \uOOOO through 
\uOOff. By using an internal syntax table, the stream tokenizer determines 
whether the character represents white-space, the start of a comment, part 
of a comment, end-of-file, end-of-line, the start of a number, part of a num- 
ber, the start of a word, part of a word, part of a string literal, or something 
else. By default, each StreamTokenizer object recognizes end-of-file, end-of- 
line, number, word, string literal, and individual characters as tokens — and 
ignores white-space, Ch-h-'s slash-slash-style single-line comments and C- 
style slash-star comments that do not span multiple lines. To help you in 
obtaining token values and identifying token types, StreamTokenizer 
declares a variety of useful fields, which appear in Table 15.4. 
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Table 15.4: StreamTokenizer Fields 

Field Description 

nval holds a numeric token's value, 
sval holds a word token's value or the contents of a 
string literal. 

A constant that identifies end-of-file. (It would proba- 
bly be more accurate for StreamTokenizer to declare 
a TT EOS constant that identifies end-of-stream.) 
A constant that identifies end-of-line. 
A constant that identifies a numeric token. Value 
can be read from nval. 

A constant that identifies a word token. Value can 
be read from sval. 

Type of most recently read token (TT_EOF, TT_EOL, 
TT_NUMBER, or TT_woRD), a quote character (to indi- 
cate a string literal), or the value of a single charac- 
ter. If ttype is set to TT_NUMBER, nval contains a 
numeric token's value. If ttype is set to TT_WORD, 
sval contains a sequence of alphabetic, digit, and 
other characters. If ttype is set to a quote charac- 
ter, sval contains all characters found between a 
pair of quote characters. Othen/vise, ttype contains 
a single character that is in the miscellaneous token 
category. 

Before you can extract tokens from an input stream, you need a 
StreamTokenizer object. To initialize a StreamTokenizer object, call the 
StreamTokenizer(Reader r) constructor with a reference to an object created 
from a subclass of the abstract Reader class. (If you recall, readers are input 
streams that return characters instead of bytes.) After that's done, you can 
call methods to set up the syntax table (if desired) followed by multiple 
calls to the nextToken() method, to extract tokens. Table 15.5 presents 
StreamTokenizer's methods. 

Table 15.5: StreamTokenizer Methods 
Method Description 

void commentChar(int c) Identify c as the start of a single-line comment. All 

characters from c to the end of the current line are 
ignored by the stream tokenizer. 
void eolisSignif leant Determine whether or not end-of-line is treated 

(boolean flag) as a token. If flag is true, either a carriage return 

character, a newline character, or a carriage return 
character followed by a newline character is treated 
as end-of-line. When end- 



double nval 
String sval 

int TT_EOF 

int TT_EOL 
int TT_NUMBER 

int TT_WORD 

int ttype 
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Table 15.5: continued 



Method 



Description 



int linenoO 

void lowerCaseMode 

(boolean flag) 

int nextTokenO 

void ordinaryChar{int c) 



void ordinaryChars(int loc, 
int hie) 

void parseNumbers { ) 



void pushBackO 

void quoteChar(int c) 

void resetSyntax( ) 



of-line is detected, ttype is set to TT_EOL. 
Otiierwise, carriage return and new/line are sepa- 
rately assigned to ttype (by successive nextToken() 
metliod calls). 

Return the current line number. 
Lowercase all uppercase characters in 
sval if flag is true, and a TT_WORD token is encoun- 
tered when nextTokenO is called. 
Return the next token from the input stream. If an 
I/O problem occurs, throw an lOException object. 
Identify c as an ordinary character. No special signifi- 
cance (such as being the start of a comment, being 
a string delimiter, and so on) is attached to the char- 
acter. When encountered by nextTokenO, the char- 
acter's numeric value is assigned to ttype. Think of 
ordinary characters as belonging to the miscella- 
neous token category. 

Identify all characters whose numeric values 
range from loc to hie as ordinary characters. 
Indicate that floating-point numbers should be 
returned as single tokens (instead of three tokens: 
an integer representing the whole part, a period 
character representing a decimal point, and an inte- 
ger representing the fractional part). When a float- 
ing-point number is encountered, ttype is set to 
TT_NUMBER and nval is assigned the floating-point 
value. By default, numeric tokens are integers. 
Cause the next nextTokenO method call to return 
ttype's value and not modify either nval or sval. 
Identify e as the delimiter of a character sequence 
that indicates a string literal. When encountered by 
nextToken ( ) , ttype is set to e, and sval is assigned 
all characters between matching pairs of the quote 
character represented by e. 

Reset the current stream tokenizer's internal syntax 
table so that all characters are treated as ordinary 
characters. 
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Table 15.5: continued 




EXAMPLE 



Method 



void slashSlashComments 
(boolean flag) 



void slashStarComments 
(boolean flag) 



void whitespaceChars(int 
int hie) 



Description 



loo, 



void wordChars(int 
int hie) 



loe, 



Indicate that the current stream tokenizer 
recognizes the C++ slash-slash comment style, 
if flag is true. All characters from // to end-of- 
line are ignored. 

Indicate that the current stream tokenizer 
recognizes the C slash-star comment style, if 
flag is true. All characters between succes- 
sive occurrences of /* and */ (even if /* and */ 
appear on different lines) are ignored. 
Identify all characters whose numeric values 
range from loc to hie as white-space charac- 
ters. Such characters serve to separate tokens 
and are not returned by calls to nextiokeno. 
Identify all characters whose numeric values 
range from loc to hie as word characters. Such 
characters indicate the start of identifiers. 



NOTE 

By default, a StreamTokenizer object recognizes single-quote (') and double-quote (") 
characters as quote characters. 

Listing 15.19 presents source code to an ExtractTokens application that 
demonstrates using StreamTokenizer to extract tokens from a file stream. 
ExtractTokens subsequently classifies those tokens. 

Listing 15.19: ExtractTokens. java. 
// ExtractTokens. java 



import java.io.*; 

class ExtractTokens 
{ 

public static void main (String [] args) 
{ 

if (args . length != 1 ) 
{ 

System. err. println ("usage: java ExtractTokens filename" 
return; 

} 



FileReader fr = null; 



try 
{ 
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Listing 15.19: continued 

fr = new FileReader (args [0]); 

StreanTokenizer st = new StreamTokenizer (fr); 

while {st . nextToken () != StreamTokenizer. TT_EOF) 
{ 

switch (st.ttype) 
{ 

case ' " ' : 

System. out. println ("String = " + st.sval); 
break; 

case StreamTokenizer. TT_EOL: 

System. out .println ( "End -of -line" ) ; 
break; 

case StreamTokenizer. TT_NUMBER: 

System. out. println ("Number = " -i- st.nval); 
break; 

case StreamTokenizer. TT_WORD: 

System. out. println ("Word = " -i- st.sval); 
break; 

default : 

System. out. println ("Other = " -i- (char) st.ttype); 

} 

} 

} 

catch (FileNotFoundException e) 
{ 

System. out. println ("Cannot find file " -^ args [0]); 

} 

catch (lOException e) 
{ 

System. out. println ; 

} 

finally 
{ 

if (fr != null) 
try 
{ 

fr. close 0; 



18 71710_CH15 11/21/01 4:23 PM Page 682 




682 Chapter 15: Files and Streams 



Listing 15.19: continued 
} 

catch (lOException e) 

{ 

} 

} 

} 

} 

ExtnactTokens attempts to open a text file. If the open succeeds, it employs a 
While loop statement to retrieve all tokens until the next retrieved token 
indicates end-of-file. For each returned token, a Switch decision statement 
attempts to classify that token (by its type) as a string literal, end-of-line, a 
word, a number, or something else. Based on the token's type, information 
about that token prints. 



TIP 

By default, StreamTokenizer ignores C++-style comments and non-multiline C-style 
comments. As a result, it would seem unnecessary to call slashSlashComments (true) 
and slashStarComments (true) after creating a StreamTokenizer object. The "slash" 
methods exist because of the ordinaryChar( ) and ordinaryCharsO methods. Either 
of the "ordinary" methods can turn a backslash character into an ordinary character. 
After that's done, C++-style and C-style comments are not ignored. In that situation, the 
only way to ignore those comments is to call slashSlashComments(true) and 
SlashStarComments (true) . (You also need to call slashStarComments(true) to 
ignore multiline C-style comments.) 



What's Next? 



This chapter completes a tour of the Java language and some APIs. I would 
like to have covered more APIs, but this book is large and would become 
unwieldy if I attempted to focus on every API that I feel needs to be cov- 
ered. Instead, I have attempted to provide a thorough treatment of the 
Java language and a few important APIs. 

If you have enjoyed this book and would like to see a two-volume (or even 
three-volume) set of Java 2 By Example (Third Edition) books that covers 
Java 2 Standard Edition (and some extensions), please contact Que 
Publishing. My plans for a third edition include: 

• Coverage of the SDK 1.5 release. 

• A volume that explores the Java language (including SDK 1.5's 
expected support for parametric polymorphism) and includes a chapter 
on object-oriented analysis and design. Several APIs would be covered 
in the first volume. 
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• A second volume that includes chapters on more APIs, including the 
JFC (AWT, Swing, Accessibility, Java 2D, and Drag and Drop), Java 
Sound, internationalization, JavaBeans and reflection, networks, secu- 
rity, JDBC, regular expressions, non-blocking I/O, and debugging and 
profiling (including extensive coverage of SDK 1.4's Logging API). 
Also, the second volume would cover the virtual machine, including 
the Java Native Interface, class file format, JVM architecture, and 
instruction set — with a GUI-based Java disassembler. 

• A third volume that includes chapters on RMI, XML, Corba and some 
non-core Java APIs (such as the Java Media Framework, Java 3D, the 
Java Speech API, JavaHelp, and so on). 

Before you close this book, test your understanding of the current chapter 
by completing the Reviewing It, Checking It, and Applying It activities. 

NOTE 

The answers to the Reviewing It, Checking It, and Applying It activities are available in 
Appendix A, "Answers" at the end of the book. 



Reviewing it 



One way to improve your understanding of the current chapter is to answer 
a few review questions. For each of the following questions, spend some 
time thinking about the question and then write a brief paragraph that 
sums up your answer: 

1. In what ways does a pathname violate portability? 

2. Table 15. 2's description of File's createTempFile (String prefix, String 
suffix) method states that a temporary file is created in the default 
temporary data file directory. How does Java locate that directory? 

3. What is the difference between the FileFilter and FilenameFilter 
interfaces? 

4. RandortiAccessFile declares a getFD( ) method. What is the purpose of 
that method? 

5. Java's standard class library includes a pair of classes named 
inputStreartiReader and OutputStreamWriter. What is the purpose of 
those classes? 



6. 



Because static fields are not serialized, what values do they contain 
when an object deserializes? 
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7. Suppose an object is created from a class whose superclass imple- 
ments the Serializable interface and you do not want that object to be 
serialized. How can you prevent serialization? 

8. When would you use StreamTokenizen's pushBack( ) method? 



Checking It 



A second way to improve your understanding of the current chapter (and 
identify any weak spots in this understanding) is to select the correct choice 
in each of 10 multiple-choice questions and determine whether each of 10 
statements is true or false. 

Multiple Choice 

Answer each of the following multiple-choice questions by drawing a circle 
around one (and only one) of the letters a, b, c, or d that identify the ques- 
tion's four choices: 

1. Which of the following abstract pathname methods can throw an 
lOException object? 

a. getNameO 

b. getCanonicalPath( ) 

c. getPathO 

d. getPanentO 

2. Which of the following file-manipulation methods helps achieve a 
cooperative file-locking protocol? 

a. createTempFileO 

b. deleteO 

c. deleteOnExitO 

d. setLastModifiedO 

3. Which of the following RandomAccessFile methods writes a two-byte 
length field before writing all characters in the String object refer- 
enced by s? 

a. writeUTF(String s) 

b. writeChars (String s) 

c. writeBytes(String s) 

d. None of the above 
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4. DataOutputStream and which of the following classes implement the 
DataOutput interface? 

a. FileOutputStream 

b. ObjectOutputStrearr 

c. File 

d. None of the above 

5. Which standard I/O stream cannot always be redirected? 

a. Standard input 

b. Standard output 

c. Standard error 

d. All of the above 

6. Which Process method returns a stream that connects to the standard 
output stream of the process associated with the current Process 
object? 

a. getlnputstream( ) 

b. getOutputStream( ) 

c. getErrorStream( ) 

d. getConnectedOutputStream( ) 

7. Which serialization and deserialization mechanisms require you to 
implement the private void writeObject(ObiectOutputStream oos) and 
private void readObj ect (Obj ectlnputStream ois) methods? 

a. Externalization 

b. Default serialization and deserialization 

c. Custom serialization and deserialization 

d. None of the above 

8. Which exception is thrown by Obj ectOutputStream's writeObj ect ( ) 
method when "asked" to serialize an object from a class that does not 
implement the Serializable interface? 

a. lOException 

b. InvalidClassException 

c. ClassNotFoundException 

d. NotSerializableException 
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9. Which exception is thrown by ObjectlnputStream's readObjectO 
method when it encounters unexpected (non-control) data on an 
input stream while trying to deserialize an object? 

a. ClassNotFoundException 

b. OptionalDataException 

c. StreamCorruptedException 

d. InvalidClassException 

10. By default, StreamTokenizer recognizes what quote characters? 

a. Single-quote and double-quote 

b. Single-quote only 

c. Double-quote only 

d. Single-quote, double-quote, and apostrophe (~) 
True or False 

Answer each of the following true/false statements by drawing a circle 
around either True or False: 

1. An abstract pathname always begins with a prefix string. 
True/False 

2. File's mkdirs( ) method creates any needed parent directories in addi- 
tion to the directory specified by a File object's abstract pathname. 

True/False 

3. Flat-file databases can be accessed only in a random manner. 
True/False 

4. The FileReader and FileWriter classes create stream objects that 
read/write binary data from/to files. 

True/False 

5. Buffered streams support the capabilities of marking a location in a 
stream and resetting the stream to that location so that a sequence of 
bytes (or characters) can be reread. 

True/False 
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6. It is desirable for the same thread to write data to a piped output 
stream and read that data back from a piped input stream that is con- 
nected to the piped output stream. 

True/False 

7. Zip streams are examples of filter streams. 
True/False 

8. Neither PrintStream's nor PrintWriter's various printing methods throw 
exceptions. 

True/False 

9. Externalization provides limited control over the serialization and 
deserialization tasks. 

True/False 

10. By default, a StreamTokenizer object does not ignore C++-style com- 
ments (that is, it returns the characters comprising a C-n-style com- 
ment as a sequence of tokens). 

True/False 



Applying It 



A final way to improve your understanding of the current chapter is to 
work on the following exercises: 

APPLY " 

1. Write a code fragment that represents a platform-independent path- 
name for a file named a.dat in a directory named temp underneath the 
root directory. 

2. Write a Dir application that prints the names of all files (data files and 
directories) located in the current directory. 

3. Modify the previous exercise's Dir application so that it takes an 
optional argument. If that argument is specified, it represents the 
extension that a filename must have for it to be displayed. For exam- 
ple, java Dir html displays only those filenames whose extensions 
match html. If no argument is specified, all filenames should be dis- 
played. (Hint: you will need to use either FileFilter or 
FilenameFilter.) 

4. Modify Listing 15.2's Touch utility to not rely on class Date and to take 
an optional argument that identifies a directory. If a directory is speci- 
fied, all files in that directory must be "touched." Otherwise, all files in 
the current directory must be "touched." For example, java Touch sets 
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the time of all files in the current directory to the current time, but 
(assuming Windows) java Touch \temp sets the time of all files in the 
\temp directory to the current time. If a file is specified instead of a 
directory (such as java Touch Touch, java), have Touch print out the 
message directory expected. 

5. Flat-file databases can be accessed in a sequential manner, as well as 
a random manner. Write an SAFFDBDemo (sequential-access flat-file 
database demo) application that does the following: 

Create a file called months.dat and store 12 records. The first field in 
each record contains a month name and the second field contains the 
number of days in that month. Use the following data: January 31, 
February 28, March 31, April 30, May 31, June 30, July 31, August 31, 
September 30, October 31, November 30, and December 31. After the 
last record is written, close months.dat. Reopen months.dat and read all 
records. For each record, print the month name followed by the num- 
ber of days on the same line. To perform file writing and reading, do 
not use RandomAccessFile. Instead, use the file and data stream classes. 

6. Java's standard class library includes a filter stream class called 
LineNumberReader. LineNumberReader objects offer the capabilities of 
reading entire lines of text (where each line is terminated by a car- 
riage return character, a newline character, or a carriage return char- 
acter immediately followed by a newline character), via the readLineO 
method, and associating a line number with each line, that returns via 
the getLineNumber( ) method. Given that knowledge, write a LineViewer 
application that chains a LineNumberReader object to a FileReader 
object. Introduce a While loop statement that repeatedly calls the 
readLineO method (until that method returns null, signifying end-of- 
line). For each string object returned by readLineO, call the 
getLineNumber( ) method to return the line number as an integer, and 
print that number along with the String. 

7. Modify Listing 15.10's ZipReader source code so that each Zip entry 
name (that prints) is followed by two spaces, an open square bracket, 
the uncompressed size of the Zip entry, a closed square bracket, two 
spaces, an open square bracket, the entry's modification time (as a 
human-readable string and not as a long integer), and a closed square 
bracket. (Hint: To display the modification time as a human-readable 
string, investigate the Date class's methods.) 
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8. Create a static getoouble ( ) method that calls System . in . read ( ) to 
input a sequence of characters representing a floating-point number. 
Use a StringBuff er to save characters as they are entered and 
Double. panseDoubleO to convert the StringBuff er's contents to a double, 
which returns fi"om getDouble(). Insert the getDouble() method into a 
Multiply application. From that application's main() method, prompt 
the user to enter the first of two numbers and call getoouble ( ) to read 
that number. Then, prompt the user to enter the second number and 
call getDouble( ) to read that number. Finally, multiply both numbers 
and display the product. 

9. Write an SDVector application that demonstrates serializing and dese- 
rializing a Vector object. Populate the Vector with a variety of objects 
prior to serialization and enumerate (and print) the deserialized 
Vector's contained objects. What problem are you likely to encounter 
when serializing a Vector (or other container class) object? 

10. The ExtractTokens application in Listing 15.19 has a problem. It does 
not classify a string literal surrounded by a pair of single-quote char- 
acters, even though StreamTokenizer recognizes the single-quote char- 
acter as a delimiter character for string literals. Modify that 
application so that it also recognizes single-quote characters. 
Furthermore, modify ExtractTokens so that it lowercases all uppercase 
characters in sval when a TT WORD token is detected. 
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Answers to Chapter 1 




REVIEW 



Reviewing It 



1. Five features that Java uses to help you write "bug-free" code are the 
absence of unsafe constructs (such as pointers, operator overloading, 
destructors, memory deletion, and multiple implementation inheri- 
tance), support for arrays with bounds checking, a completely object- 
oriented language that promotes reusability, no undefined or 
architecture-dependent constructs (such as types whose sizes vary 
from platform to platform), and strict type checking. 

2. Sun's Java compiler requires you to specify a . j ava file extension to 
make it harder to compile anything but Java source code. For exam- 
ple, without the . j ava file extension restriction, a Java newcomer 
might accidentally try to compile a Java class file (or something else) 
and become confused by all the error messages that result. It is still 
possible to use Sun's Java compiler to try to compile a file of some- 
thing other than Java source code. However, the compiler will not 
accept this file until you explicitly give it a . j ava extension (which 
forces you to think about what you are doing). 

3. Java was not designed with the World Wide Web in mind: It was origi- 
nally designed for use in consumer devices. However, Java's portabil- 
ity and security assets were found to be essential to running 
Web-based software. As a result, Java found a new "home" in the Web. 

4. It is a good idea to completely uninstall a previous version of a Java 
JDK/SDK before installing a new version to prevent conflicts between 
different installed versions from arising. When multiple JDKs/SDKs 
are installed, the source of those conflicts can be difficult to track 
down, resulting in many hours of frustration. 

5. An advantage in using Sun's SDK command-line tools over an IDE is 
that you have complete control over the creation and execution of Java 
software. As to a disadvantage, an IDE is typically much simpler to 
use than the SDK command-line tools — especially to developers not 
familiar with the concept of a command line. 

6. An application differs from an applet in that an application is a stand- 
alone program whereas an applet runs in the context of a Web 
browser. Furthermore, applets are restricted in what they can do — 
applications (by default) are not subject to such restrictions. 
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7. If you run Craps (or any Java program) and receive an error message 
stating that a class cannot be found, the reason is probably because 
the CLASSPATH environment variable does not include the current direc- 
tory in its list of directories. To correct that situation, you append a 
period character (which represents the current directory) to CLASSPATH. 
For example, under Microsoft Windows, specify set classpath= 
%classpath%; . . 

8. Java does not include a sizeof operator because all types have well- 
defined sizes. Furthermore, sizeof is often used in C++ to aid in the 
creation of an object from an array of bytes — a practice that is not 
possible in Java. 

9. Well-defined primitive type sizes promote portability by guaranteeing 
that the same range of values is supported on all platforms. In con- 
trast, if sizes vary from one platform to the next, one platform will be 
capable of supporting a greater range of values (for a given type) than 
other platforms. If a program assumes a certain range is supported, it 
won't work correctly on other platforms with a smaller range. For 
example, suppose a short integer type supports integer values ranging 
from -32,768 to 32,767 (inclusive) on one platform and -128 to 127 
(inclusive) on another platform. Now, suppose a short integer is used 
to count the number of letters in a text file. Finally, suppose the 
length of the text file is 10,000. On the platform that supports the 
-32,768 to 32,767 range for a short integer, that counter will be able to 
accurately record a count of all letters. However, the counter on a plat- 
form supporting the -128/127 range won't be capable of recording an 
accurate count past 127. 



Checking It 



CHECK 



Multiple Choice 



1. 


c 


2. 


b 


3. 


c 


4. 


c 


5. 


a 


6. 


d 


7. 


b 


8. 


c 
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9. d 

10. a 

True or False 

1. False 

2. True 

3. True 

4. False 

5. False 

6. True 

7. True 

8. False 

9. True 
10. False 



APPLY 



Applying It 



Independent Exercise 1 

Place g.setColor (Color. cyan) ; before the Switch statement in the Die 
class's paint ( ) method. The following code fragment shows the result: 
// What cane before . . . 

g.setColor (Color. cyan) ; 

switch (nSpots) 
{ 

case 1: g.fillOval (cx - 2, cy - 2, 4, 4); 
break; 

case 2: g.fillOval (2, 2, 4, 4); 

g.fillOval (width - 6, height - 6, 4, 4); 
break; 

// And so on ... 

Independent Exercise 2 

Place a System . out . println ( ) method call at the beginning of the main ( ) 
method with your name between a pair of double quotes and place the 
result between the round brackets, as follows: 
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// What cane before . . . 

public static void main (String [] args) 
{ 

System. out. println ("Java Jeff"); 
// And so on ... 

Independent Exercise 3 

After you add a name to the Employee class, you end up with the following 
code: 

// Employee. java (Java Employee program) 

// This program creates an Employee object initialized to a specific 
// salary and then calls an Employee method to retrieve this salary. 
// The salary (and some text) is output to the standard output device. 

// 

// Class: Employee 

// 

// This class describes the structure of Employee objects. In this 
// trivial class, an Employee object consists of a salary and nothing 

// else. 

// 

class Employee 
{ 

// The Employee's salary is stored in the salary variable. Because 
// this variable is declared private, salary cannot be accessed 
// outside Employee. 

private double salary; 

// The Employee's name. 

private String name; 

/ / ======================================================= 

II Method: Employee () 

// 

// Construct an Employee object by initializing its salary 
// and name variables. 

// 

// Arguments: 
// 
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lis- the Employee's salary 

II n - the Employee's name 

/ / ======================================== 

Employee (double s, String n) 
{ 

salary = s; 
name = n; 

} 

/ / ======================================== 

II Method: getSalaryO 

// 

// Return the value of the salary variable. 

// 

// Arguments: 

// 

// nothing 

// 

// Return: 

// 

// salary variable's value 

/ / ======================================== 

double getSalary () 
{ 

return salary; 

} 

/ / ====================================== 

II Method: getNameO 

// 

// Return the value of the name variable. 

// 

// Arguments: 

// 

// nothing 

// 

// Return: 

// 

// name variable's value 

/ / ====================================== 

String getName () 
{ 

return name; 

} 
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Method: main() 

main() is the entry-point into this program. When this program 
runs, main{) is called (after any optional class initialization) 
before anything else. 

Arguments: 

args - an array of Java String objects, where each String object 
contains a command line argument. (Employee does not use 
this feature. ) 

Return : 
nothing 



public static void main (String [] args) 
{ 

// Create an Employee object with a salary that's initialized to 
// 30000.0 and a name that's initialized to Java Jeff. Also, 
// return a reference to this object, which subsequently assigns 
// to Employee reference variable e. 

Employee e = new Employee (30000.0, "Java Jeff"); 

// Output all characters between the quote characters " and ". 

// Follow this output with the contents of the salary variable 

// (by calling getSalary( ) ) . (A newline character is 

// automatically output after all other characters.) 

System. out. println ("Salary = " + e.getSalary ()); 

// Do the same thing as the previous System. out. println() except 
// for the fact that a name is being output. 

System. out. println ("Name = " + e.getName ()); 

} 

} 

// Output (when run): Salary = 30000.0 
// Name = Java Jeff 
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Answers to Chapter 2 




REVIEW 



Reviewing It 



1. A Unicode escape sequence can contain multiple u's following the 
translation of Unicode-based source code to ASCII source code — so 
that ASCII tools can be used for further processing. The translation 
involves converting any Unicode escape sequences to ASCII by adding 
an extra u (for example, \uxxxx becomes \uuxxxx) while simultaneously 
converting each Unicode character to a \uxxxx escape sequence. 

2. When the compiler encounters \ \u0042 in ASCII source code, it regards 
\\u0042 as a sequence of seven separate ASCII characters and trans- 
lates each ASCII character into an equivalent Unicode character. 
However, when \\\u0042 is encountered, the compiler regards \\\u0042 
as a backslash followed by a Unicode escape sequence, translates the 
first two ASCII backslashes to a single Unicode backslash, and trans- 
lates the remaining six ASCII characters to a Unicode capital letter A. 

3. The "byte to character" rule exists because byte is a signed integer 
type capable of representing negative values, whereas character is an 
unsigned type capable of only representing positive values — and a 
character cannot represent a byte's negative values. 

4. Two ways in which Java's designers have simplified working with the 
String class are simplified assignment (for example. String s = "abc" ; 
instead of String s = new String ( "abc" ) ;) and the introduction of a 
string concatenation operator (for example, s = s + "def";). 

5. An interface type differs from a class tj^e in that an interface type 
specifies no implementations for its operations, whereas a class type 
specifies implementations. 

6. Use the double-precision floating-point type when accuracy is of 
utmost importance and the floating-point type when memory, and/or 
processing speed is more important. Because the double-precision 
floating-point type representation requires 64 bits of memory whereas 
the floating-point type representation requires 32 bits, a double- 
precision floating-point value requires twice as much memory as a 
floating-point value. Also, the extra memory results in a slight 
increase in processing time for double-precision floating-point values. 
However, the double-precision floating-point type can more accurately 
represent a larger range of values. 



7. 



Java probably does not allow multiline comments to nest because it 
might be difficult for the Javadoc tool to extract information from 
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CHECK 



documentation comments (which are a special form of multihne 
comment) that are nested in other multihne comments. 



Checking It 



Multiple Choice 

1. b 

2. a 

3. d 

4. a 

5. c 

6. b 

7. c 

8. d 

9. c 
10. b 

True or False 

1. False 

2. False 

3. True 

4. False 

5. True 

6. False 

7. True 

8. True 

9. False 
10. True 
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Applying It 



Independent Exercise 1 

APPLY rpj^g name given to the Unicode characters ranging from \u30A0 through 
\u30FF is Katakana. 

Independent Exercise 2 

Five valid identifiers are numEmployees, degrees, \u0042, i, and days_in_yean. 
Five invahd identifiers are 6days, \u0030, alb, first name, and : amount. 

Independent Exercise 3 

The primitive types appearing in Chapter I's Craps, java source code are 
Boolean (by way of the boolean keyword) and integer (by way of the int key- 
word). 



Answers to Chapter 3 




REVIEW 



Reviewing It 



1. The additive operators are not associative when the operands are 
either floating-point or double-precision floating-point because of spe- 
cial mathematical values like +lnf inity. Consider the following code 
fragment: double d = le308; double d2 = d + d - d; double d3 = d + 
(d - d) ;. When that code fragment executes, d2 will contain +lnf inity, 
but d3 will contain le308. (Chapter 15 discusses +lnf inity and other 
special mathematical values in detail.) 

2. The cast operator is required when assigning to b3 but not required 
when assigning to b2 in the compound assignment b2 += bl because, 
according to the JLS, b2 += bl is equivalent to b2 = (byte) (bl + 
b2);. 

3. The JLS defines a primary expression as the simplest kind of expres- 
sion. Primary expressions include literals. 

4. If you declare and initialize an array consisting of two elements and 
then try to access an element using index 2, the JVM throws an 
ArraylndexOutOfBoundsException object. (Chapter 9 discusses excep- 
tions.) That happens because there are only two elements, located at 
indexes 0 and 1, and an attempt to access a nonexistent element at 
index 2 makes no sense. 



5. 



The expression null + " is null" is legal because + is used to perform 
string concatenation when at least one operand is of type String, and a 
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non-String expression of any type can be specified as an operand to 
that additive operator. 

6. The variable declaration in t \3063 = \u0beb; is not legal because 
\u0beb, although a valid Tamil digit character, is not considered an 
integer literal, as defined by the JLS. 

7. The difference between the expression 'A' + 10 and the expression "A" 
+ 10 is: 'A' + 1 0 is a numeric expression. The additive operator first 
evaluates its left-hand operand ('A'), by converting it from character 
to integer, and then evaluates its right-hand operand (10). Both values 
are added, and the sum, integer 75, is returned. In contrast, "A" + 10 
is a string expression. The additive operator first evaluates its left- 
hand operand ("A") and then evaluates its right-hand operand (10) by 
converting it to a string. The resulting characters (1 and 0) are con- 
catenated to A, and a new string, A10, is returned. 

8. char c = ' \ 000a '; is incorrect because the compiler translates \ 000a 
into a single new-line character prior to compiling. The preceding code 
then looks like char c = ' (followed by ' ; on the next line) to the com- 
piler. That can be corrected by replacing \u000a with \n. The corrected 
code is now char c = ' \ n ' ;. By the way, something similar can be said 
for char c = ' \000cl ' ; . That invalid code can be corrected by replacing it 
with char c = ' \ r ' ; . 



Checking It 



Multiple Choice 



1. 


c 


2. 


d 


3. 


a 


4. 


b 


5. 


a 


6. 


b 


7. 


d 


8. 


c 


9. 


b 


10. 


b 
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True or False 



False 
True 
False 
True 
True 
False 
False 

8. True 

9. False 
10. True 



1. 
2. 
3. 
4. 
5. 
6. 
7. 



APPLY 



Applying It 



Independent Exercise 1 

Consider the expression 20 + 2 * 3 % 6 - 10. First, 2 * 3 is evaluated, 
which yields 6. Then, 6 % 6 is evaluated, which yields 0. Subsequently, 20 + 
0 is evaluated, yielding 20. Finally, 20 - 10 is evaluated, resulting in 10. 

Now, consider the expression 10 / 3 - 6 * 15. First, 10 / 3 is evaluated, 
which yields 3. Second, 6 * 1 5 is evaluated: The result is 90. Finally, 3 - 90 
is evaluated, producing - 87 as the final result. 

Finally, consider the expression ( 8 + x) * 3 / ((++x)) — where x is an in t 
initialized to 1. First, (8 + x) is evaluated, which yields 9. Second, 9 * 3 is 
evaluated, producing 27. Third, ++x is evaluated, causing the value of x to 
increment from 1 to 2. Finally, 27 / 2 is evaluated, resulting in 13. 

But wait! Don't expressions within the innermost parentheses — such as 
( (++x) ) — evaluate first? Shouldn't the value of that expression be 15? 
Although the innermost parentheses are evaluated first, the expression's 
value is 13. The reason is that the expression's / operator fully evaluates its 
left operand — (8 + x) * 3 — ^before it fully evaluates its right operand — 

((+ + X)). 



Independent Exercise 2 

string [] names = { "one", "two", "three" }; 
System. out. println (names. length) ; 
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Independent Exercise 3 



int X = 2; 
System. out. println 



(X == 2 ? "Hello" : "Goodbye"); 



Answers to Chapter 4 




REVIEW 



Reviewing It 



1. Every statement does not end with a semicolon character. For exam- 
ple, consider the If decision statement. That statement consists of key- 
word if followed by a left bracket character followed by a Boolean 
expression followed by a right bracket character. A separate statement 
immediately follows. If that other statement consists of only a semi- 
colon character, that semicolon character is known as the Empty 
statement: It does not end the If. 

2. Local variable declaration statement int x = x = 2; is legal because 
Java first creates x and then evaluates x = 2. The result of that evalu- 
ation is that X contains 2. Java then interprets the statement as if it 
were int x = 2;. The result is: x is twice assigned 2. 

3. It is my thought that a Switch decision statement's expression cannot 
be of long integer type because, according to the JLS, longs "are 
treated as if they were two variables of 32 bits each." That means a 
read or write operation on a long integer is not atomic. In other words, 
it is possible for one thread to read part of a long integer and then be 
interrupted by a second thread, which modifies the long integer before 
the first thread gets a chance to read the second part of the integer. 
(That kind of problem would occur on 32-bit platforms.) The lack of 
integrity on a long integer could have complicated the implementation 
of Switch: The simplest solution would be to not support the long inte- 
ger type in a Switch decision statement's expression. (You'll learn more 
about threads in Chapter 10.) 

4. Java does not allow a Local variable declaration statement to be 
labeled because it would then be possible to write Break or Continue 
loop control statements whose target is a Local variable declaration 
statement. That would introduce the possibility of redeclaring the 
same local variable over and over — which is illegal. 

5. If a default case is specified before other cases in a Switch decision 
statement. Switch will always execute the default case. The execution 
of other cases will depend on how the default case is organized. For 
example, if the default case ends with a Break statement, no other 
cases will execute. 
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6. Code fragment for (boolean b = false; b != true; b = !b) 
System . out . println ( b ) ; is legal because it's equivalent to the follow- 
ing legal code fragment: boolean b = false; while (b != true) { 
System. out. println (b); b = !b; } — and every For can be expressed 
as a While. 

7. Java doesn't allow uninitialized local variables to be read because 
such variables contain unpredictable startup values — whatever was in 
memory when they were created. Imagine using an uninitialized vari- 
able to control a loop. Sometimes, the loop would work one way, and 
other times the loop would work another way. For example, int count 
= 0, x; while (x < 10) count++; results in count containing 10 if x's 
startup value is 0, 5 if x's startup value is 5, and 0 if x's startup value 
is 100. (The loop doesn't execute even once when x contains 100.) That 
is an example of a logic error. Why doesn't Java initialize local vari- 
ables to default values? Java could do that, but initializing local vari- 
ables (especially if a local variable is created thousands of times in a 
loop) would impact performance. 



Checking It 



Multiple Choice 

1. b 

2. c 

3. a 

4. b 

5. d 

6. d 

7. c 

8. a 

9. b 
10. c 



True or False 

1. True 

2. False 

3. True 
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4. 


False 


5. 


False 


6. 


True 


7. 


True 


8. 


False 


9. 


True 


10. 


True 



Applying It 



Independent Exercise 1 

a. double diameter = 10; double radius = diameter / 2; double 
circumference = 3.14159 * diameter; double area = 3.14159 * radius 
* radius; 

b. int product = 1; for (int i = 2; i <= 8; i++) product *= i; 

c. double temp = 37.0; double f = 9.0 / 5.0 * temp + 32.0; temp = 
32.0; double c = 5.0 / 9.0 * (temp - 32.0); 

Independent Exercise 2 

a. There are two errors. First, count is not declared as a variable. Second, 
while executes an Empty statement and does not increment count. The 
result is an infinite loop. 

b. There is one error. The case whose tag equals 1 does not end in a 
break statement. As a result, one followed by two prints, which is not 
correct — only one should print. 

c. There are two errors. First, commas are used instead of semicolons to 
separate for's three clauses. Second, the loop is infinite because the 
update clause contains x++ instead of x - - . 

Independent Exercise 3 

int n = 1 ; 
if (n == 0) 

System. out. println ("zero"); 

else 

if (n == 1) 

System. out. println ("one"); 

else 
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if (n == 2) 

System. out. println ("two"); 

Independent Exercise 4 

// Reverselnt. Java 

class Reverseint 
{ 

public static void main (String [] args) 
{ 

int num = 1234567890; 

int [] digits = { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 }; 

// Extract individual digits from num and store in array. 

int i = 0; 
while (num != 0) 
{ 



digits [i++l = num % 10; 
num /= 10; 




// Print digits in reverse. 



for (i = 0; i < digits. length; i++) 
System. out. print (digits [i]); 

} 

} 

Independent Exercise 5 

// Diamond. java 

class Diamond 
{ 

public static void main (String [] args) 
{ 

// 

// Print the upper half. 

// - 

for (int i = 1 ; i < 10; i += 2) 
{ 

for (int i = 0; i < 9 - i / 2; ]++) 
System. out. print {" "); 
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for (int i = 0; i < i; 

System. out. print {"*"); 

System. out. print ("\n"); 



} 



// Note: i is now out of scope because its scope ranges from 
// the init clause to the end of the block following 

// for (int i = 1 ; i < 10; i+= 2) . 



// 



// Print the lower half. 

// 

for (int i = 7; i > 0; i -= 2) 
{ 

for (int i = 0; i < 9 - i / 2; ]++) 
System. out. print (" "); 

for (int i = 0; i < i; 

System. out. print ("*"); 

System. out. print ("\n"); 



Answers to Chapter 5 




REVIEW 



Reviewing It 



1. Methods cannot be declared inside other methods. However, it is possi- 
ble to declare classes inside methods and methods inside classes. 
Chapter 8 discusses that capability. 

2. A class cannot be declared abstract and final at the same time 
because an abstract and final class makes no sense. When a class is 
declared abstract, no objects can be created from that class. The type 
represented by the class is too generic for representing objects. The 
idea is to subclass the abstract class and create objects from its non- 
abstract subclass. However, a final class cannot be subclassed. As a 
result, an abstract and final class is useless. 



3. Two useful kinds of classes that declare private constructors are sin- 
gletons and classes that implement enumerated types. 
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4. Object-based programming (and, by extension, object-oriented pro- 
gramming) differs from traditional structured programming as fol- 
lows: The structured programming approach to solving a problem 
takes the problem and converts it to code that fits within the artificial 
constructs of a programming language. Development usually begins 
with functions (named blocks of statements that return values) and 
procedures (named blocks of statements that don't return values), and 
then moves to the development of data structures (variables and com- 
binations of variables). Functionality is seen to be the "engine" of a 
program and its importance is often emphasized over the data (stored 
in data structures). In contrast, the object-based (and object-oriented) 
approach to solving a problem uses a language to model a problem in 
the way people perceive the world. Code and data structures are 
encapsulated in classes and neither is viewed as more important than 
the other. Both code and data structures work together, as a type 
implementation, to solve a problem — and a program's objects, which 
are capable of passing messages to each other (by calling each other's 
methods), are seen to be the program's "engine." 

5. From Java's perspective, "sending a message to an object" means: call 
one of that object's methods. 

6. Fields should be declared private to a class because of information 
hiding, which states that a developer should be aware of a class's 
capabilities but not the implementation of those capabilities. 

7. In a narrative description of a problem, nouns suggest classes and 
object reference variables. Also, verbs suggest methods. 

8. Constructors are not allowed to have return types because constructor 
calls (outside a class) appear together with new — and new is not 
designed (in Java and C++) to return both a reference to an object and 
a constructor return value. If a constructor could return a value, that 
value would more than likely signal some kind of initialization failure, 
and there is a better way to handle that kind of failure (see Chapter 
9). 

9. A global variable can be achieved in Java by declaring a publicly 
accessible class field in a publicly accessible class. For example: public 
class Global { public static int myGlobalInt; }. 
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Checking It 



Multiple Choice 



1 

i. 


c 


2. 


b 


3. 


d 


4. 


a 


5. 


b 


6. 


c 


7. 


a 


8. 


d 


9. 


c 


10. 


d 



True or False 

1. False 

2. True 

3. False 

4. False 

5. True 

6. False 

7. True 

8. False 

9. False 
10. True 



APPLY 



Applying It 



independent Exercise 1 

There are six mistakes in the Mistakes, java source code: 

1. The first mistake is the presence of keyword abstract in the class dec- 
laration. That keyword indicates that no objects can be created from 
Mistakes. However, the main() method tries to create a Mistakes object. 
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2. The second mistake is the presence of keyword void as the construc- 
tor's return type. Constructors cannot have return types. 

3. The third mistake is x = x; in the constructor. That Expression state- 
ment assigns the contents of parameter x to parameter x — not field x — 
because parameter x shadows field x. 

4. The fourth mistake is the presence of keyword static in static int 
count ( ). That method is designed to return the contents of instance 
field x. However, an instance field cannot be accessed from a class 
method. 

5. The fifth mistake is the failure to return x from count () . When a 
method's signature does not include void, a Return statement must be 
used to return a value of the appropriate type. Specifying keyword 
return by itself is not sufficient. 

6. The sixth and final mistake is the absence of return x; from int count 
(String msg). 

Here is the corrected Mistakes, java source code: 
// Mistakes. java 

class Mistakes 
{ 

private int x; 

private Mistakes (int x) 
{ 

this.x = x; 

} 

int count () 
{ 

return x; 

} 

int count (String msg) 
{ 

System. out. println (msg); 
return x; 

} 

public static void main (String [] args) 
{ 

Mistakes n = new Mistakes (5); 

System. out. println (m. count ()); 

System. out. println (m. count ("# of mistakes")); 
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} 

} 

Independent Exercise 2 

// Employee. java 

class Employee 
{ 

private double salary; 
private String name; 

Employee (double salary, String name) 
{ 

this. salary = salary; 
this. name = name; 

} 

Employee () 
{ 

this (35000.0, "John Doe"); 

} 

double getSalary () 
{ 

return salary; 

} 

String getNane () 
{ 

return name; 

} 

public static void main (String [] args) 
{ 

Employee e = new Employee (); 
System. out. println (e. getSalary ()); 
System. out. println (e.getName ()); 

e = new Employee (50000.0, "Jane Doe"); 
System. out. println (e. getSalary ()); 
System. out. println (e.getName ()); 

} 

} 
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Independent Exercise 3 

// Element. java 

class Element 
{ 

private String name; 

private static int count; 

Element (String name) 
{ 

this. name = name; 
count++; 

} 

String getName () 
{ 

return name; 

} 

static int getCount () 
{ 

return count; 

} 

public static void main (String [] args) 
{ 

Element e = new Element ("Hydrogen"); 
System. out. println ("Element = " + e. getName ()); 
System. out. println ("Number of elements = " + 
Element. getCount ()); 

e = new Element ("Helium"); 

System. out. println ("Element = " + e. getName ()); 
System. out. println ("Number of elements = " + 
Element. getCount ()); 

e = new Element ("Oxygen"); 

System. out. println ("Element = " + e. getName ()); 
System. out. println ("Number of elements = " + 
Element. getCount ()); 

} 

} 

Although count is private, you can directly access count from [nain( ) because 
main() is declared in the same class as count. 
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Independent Exercise 4 

// UseElenent. Java 

class Element 
{ 

private String name; 

private static int count; 

Element (String name) 
{ 

this. name = name; 
count++; 

} 

String getName () 
{ 

return name; 

} 

static int getCount () 
{ 

return count; 

} 



class UseElement 
{ 

public static void main (String [] args) 
{ 

Element e = new Element ("Hydrogen"); 
System. out. println ("Element = " + e. getName ()); 
System. out. println ("Number of elements = " + 
Element. getCount ()); 

e = new Element ("Helium"); 

System. out. println ("Element = " + e. getName ()); 
System. out. println ("Number of elements = " + 
Element. getCount ()); 

e = new Element ("Oxygen"); 

System. out. println ("Element = " + e. getName ()); 
System. out. println ("Number of elements = " + 
Element. getCount ()); 

} 

} 
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You cannot directly access count from mainO because count is private and 
main() is in another class. UseElement is the driver class. 

Independent Exercise 5 

int sum (int n) 
{ 

if (n == 1) 
return 1 ; 

else 

return sun (n - 1 ) + n; 

} 

Call sum (10) and that recursive method returns 55. However, if you call 
sum (100000), the stack will most likely overflow. That overflow is due to the 
large number of return points and parameter variables that must be placed 
on the stack, as sum 0 repeatedly calls itself, until return sum (n - 1) + n; 
executes (where n contains 2). 

The sum() method can be made more efficient by using the mathematical 
property in which the sum of integers from 1 to n is equal to n x (n + 1) / 2. 
Changing sum( ) to use that property results in the following efficient 
method: 

static int sun (int n) 
{ 

return n * (n + 1 ) 12; 

} 

Call sum (10) and that method returns 55. However, if you call sum (100000), 
705082704 returns. Wait a minute, that isn't correct! Shouldn't sum (1000000) 
return 5000050000? Yes, it should— because 5000050000 is the correct sum. 
However, because sum( )'s return type is integer (as expressed by the int 
keyword), and because 5000050000 lies outside an integer's range, sum( ) 
cannot return the correct value. You can fix sum( ) so that it returns the cor- 
rect value, by making two changes — as expressed in the following method: 
static long sum (int n) 
{ 

return (long) n * (n + 1 ) 12; 

} 

Simply change sum( )'s return type to long integer (as expressed by the long 
keyword) and use a (long) cast to convert the return statement's expression 
from integer to long integer. Now, sum (100000) returns 5000050000. 
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Answers to Chapter 6 




REVIEW 



Reviewing It 



1. A method is declared final so that subclasses cannot override the 
method. Suppose a nonfinal method contains business logic that must 
not be changed. A subclass could override that method and make the 
change. The override would lead to a logic error, which could be diffi- 
cult to track down. Declaring the method final prevents the override 
and prevents that kind of error from occurring. 

2. The super keyword accomplishes two things. First, super calls a 
superclass constructor from a subclass constructor. That gives an 
object's superclass layer an opportunity to initialize private fields. 
Second, super accesses same-named superclass fields and calls 
same-named superclass methods from a subclass. 

3. By default. Object's equals ( ) method uses to compare the current 
object reference to the reference passed in that method's sole parame- 
ter. The behavior is not useful from an object contents comparison per- 
spective. To compare the contents of two objects, a class must override 
equals ( ) and specify appropriate comparison code. 

4. The compiler reports an error when you declare a constructor with at 
least one parameter in a superclass and do not explicitly call the 
superclass constructor from the subclass constructor for the following 
reason. The compiler inserts a call, in the subclass constructor, to the 
default no-argument superclass constructor (if the subclass construc- 
tor does not explicitly call one of its superclass constructors), and 
there is no no-argument superclass constructor in the superclass when 
you declare a superclass constructor with at least one parameter. 

5. You should not use cloning to create new objects because the cloning 
operation does not call constructors. That can lead to serious problems 
when a constructor performs tasks other than explicit initialization. 
For example, a constructor might establish a network or database con- 
nection. If you simply need a copy of an existing object with its current 
state, cloning is fine. However, if your objective is to create a brand- 
new object, use new and a constructor call. By the way, cloning requires 
a reference to an existing object. Therefore, you would have to create 
an object from a class before you could create its clone. 

6. In the CloneDemo2 application in Listing 6.6, you can change 
AnotherClass's clone ( ) method declaration by substituting the 
protected keyword for public. Considering the fact that code cannot 
call another class's default protected clone () method, that is legal 
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CHECK 



because clone () is being overridden in AnotherClass, and the protected 
overridden clone ( ) method can be accessed by all classes in the same 
package as AnotherClass. CloneDemo2 is part of the same package. 

✓ To learn more about packages, see "What Are Packages?" p. 428. 

7. Multiple implementation inheritance is a bad idea because two base 
classes either can declare the same read/write field with a different 
type and/or a different initial value or can declare the same method 
signature with a different code body. Then which field or method does 
the compiler choose to pass on to a derived class? Multiple interface 
inheritance is a good idea because implementation problems do not 
arise. That is due to restricting an interface's members to constants 
and method signatures. If two interfaces declare a constant with the 
same name but with a different type and/or initial value, the solution 
is to prefix the desired constant with the name of the appropriate 
interface wherever the constant is accessed in a class that implements 
the interface. (You cannot prefix a read/write field with a class name 
because read/write fields typically are instance fields and require 
object prefixes to distinguish among different copies.) If two interfaces 
declare the same method signature, only one code implementation for 
those methods needs to be specified in the class that implements those 
interfaces. 



Checking It 



Multiple Choice 

1. a 

2. b 

3. d 

4. c 

5. b 

6. b 

7. d 

8. c 

9. a 
10. c 
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True or False 



False 
False 
True 
False 
True 
True 
True 

8. False 

9. True 
10. False 



1. 
2. 
3. 
4. 
5. 
6. 
7. 



Applying It 



APPLY 



Independent Exercise 1 

There are five mistakes in the Errors source code: 

1. A is repeated in class C implements A, B, A. 

2. An interface is expected in class Errors implements C. However, C is a 
class. Actually, that code should read class Errors extends C. 

3. C should be declared abstract because it does not provide a code body 
for method (). 

4. The main( ) method cannot resolve PI. That is a collision because PI is 
declared with different initial values in both interfaces. 

5. Errors's declaration of method ( ) should include keyword public. As it 
stands, method () is more restrictive in Errors — it has package access — 
than it is in both interfaces (where it is implicitly public). 

Here is the corrected Errors source code: 
// Errors. java 

interface A 
{ 

double PI = 3.1415; 



void method () 
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interface B 
{ 

double PI = 3.14159; 
void method ( ) ; 

} 

abstract class C implements A, B 

{ 

} 

class Errors extends C 
{ 

public static void main (String [] args) 
{ 

System. out. println (B.PI); 

} 

public void method () 
{ 

System. out. println ("method{) called"); 

} 

} 

Independent Exercise 2 

// UseEmployee. java 

class Employee 
{ 

private String name; 
private double salary; 

Employee (String name, double salary) 
{ 

this. name = name; 
this. salary = salary; 

} 

public String toString () 
{ 

return "name = [" + name + "], salary = [" + salary + "]"; 

} 

} 

class UseEmployee 
{ 

public static void main (String [] args) 
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{ 

Employee e = new Employee {"John Doe", 45000.0); 
System. out. println (e.toString ()); 

} 

} 

Independent Exercise 3 

// UseEmployee. Java 

class Employee 
{ 

private String name; 
private double salary; 

Employee (String name, double salary) 
{ 

this. name = name; 
this. salary = salary; 

} 

public String toString () 
{ 

return "name = [" + name + "], salary = [" + salary + "]"; 

} 

} 

class Salesperson extends Employee 
{ 

private String territory; 

Salesperson (String name, double salary. String territory) 
{ 

super (name, salary); 
this. territory = territory; 

} 

public String toString () 
{ 

return super. toString () + ", territory = [" + territory + "]"; 



} 



} 



class UseEmployee 
{ 

public static void main (String [] args) 
{ 
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Employee e = new Employee {"John Doe", 45000.0); 
System. out. println (e.toString ()); 

Salesperson sp = new Salesperson ("Jane Doe", 50000.0, "North"); 
System. out. println (sp.toString ()); 

} 

} 

Independent Exercise 4 

// CloneDemo. Java 

class Engine implements Cloneable 
{ 

private int numCylinders; 
Engine (int numCylinders) 

this . numCylinders = numCylinders; 

int getNumCylinders () 
return numCylinders; 

public Object clone () throws CloneNotSupportedException 
return super. clone ( ) ; 

} 

class Vehicle implements Cloneable 
{ 

private String name; 
private Engine e; 

Vehicle (String name. Engine e) 
{ 

this. name = name; 
this.e = e; 

} 

String getName () 
{ 

return name; 

} 



20 71710_APP A 11/21/01 3:36 PM Page 723 




Appendix A 723 



Engine getEngine () 
{ 

return e; 

} 

public Object clone () throws CloneNotSupportedException 
{ 

Vehicle temp = (Vehicle) super. clone (); 

if (e != null) 

temp.e = (Engine) e. clone (); 

if (name != null) 

temp. name = new String (name); 

return temp; 

} 

} 

class CloneDemo 
{ 

public static void main (String [] args) 
throws CloneNotSupportedException 

{ 

Vehicle v1 = new Vehicle ("Half ton Pickup", new Engine (6)); 
Vehicle v2 = (Vehicle) v1. clone (); 

if (v1 == v2) 

System. out. println ("v2 is the same as v1"); 

else 

System. out. println ("v2 is a duplicate of vT'); 

String name1 = vl.getName (); 
String name2 = v2.getName {); 

if (name1 == name2) 

System. out. println ("name2 is the same as nameV); 

else 

System. out. println ("name2 is a duplicate of name!"); 

Engine e1 = v1. getEngine (); 
Engine e2 = v2. getEngine (); 

if (e1 e2) 

System. out. println ("e2 is the same as el"); 

else 

System. out. println ("e2 is a duplicate of el"); 
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if (e1 .getNumCylinders () e2.getNumCylinders ()) 

System. out. println ("Number of cylinders match"); 

else 

System. out. println ("Number of cylinders differ"); 



} 



} 



From a design perspective, we should not be creating objects from classes 
that represent generic concepts, like vehicle. Instead, we should be creating 
objects from more specific subclasses. For example, we could introduce a 
Truck class that is a subclass of Vehicle and create an object from Truck. 
However, Truck might still be too generic: We might create a more specific 
PickupTruck class that derives from Truck. 



Answers to Chapter 7 




REVIEW 



Reviewing It 



1. An abstract class serves as a repository for common subclass imple- 
mentation. In contrast, an interface introduces a type into a program. 
When combined, an abstract class implements some of an interface's 
type operations as methods. Subclasses can override those methods 
and inclusion (subtype) polymorphism (via dynamic method binding) 
makes it possible to call the right methods. 

2. Static methods are not polymorphic. For example, consider the follow- 
ing z application's source code: 

// Z.java 

class X 
{ 

static void foo () 
{ 

System. out. println ("foo in X"); 

} 

} 



class Y extends X 
{ 

static void foo () 



{ 



System. out. println ("foo in Y"); 



class Z 
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{ 

public static void main (String [] args) 
{ 

X X = new Y 0; 
x.foo 0; 

} 

} 

When run, the z appHcation prints f oo in X. If static methods were 
polymorphic, z would print f oo in Y. It is legal to call a static method 
by way of an object reference variable. When you do so, you are calling 
the method based on the object reference variable's type, not on the 
class from which the object was created. 

3. Developers place constructors in abstract classes to help in the initial- 
ization process. The idea is that an abstract class will contain some 
fields that need to be initialized. That is accomplished by having a 
subclass call the abstract superclass constructor, via super( ), to initial- 
ize those fields. In fact, if the abstract superclass's fields are private, 
the only way to initialize those fields is in the superclass's constructor. 

4. If you create a subclass of an abstract superclass and do not override 
its abstract method(s), the compiler will report an error stating that 
the subclass should also be declared abstract. 

5. Parametric polymorphism allows the compiler to verify the actual type 
of the object whose reference is assigned to a reference field (to alert 
you of an attempt to perform an invalid operation) while allowing that 
field to reference different kinds of objects. 



Checking It 



Multiple Choice 

1. b 

2. a 

3. c 

4. a 

5. d 

6. c 

7. b 

8. a 
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9. d 
10. d 



True or False 



False 
True 
True 
False 
True 
False 
False 

8. True 

9. False 
10. True 



1. 
2. 
3. 
4. 
5. 
6. 
7. 



APPLY 



Applying It 



Independent Exercise 1 

There are 10 mistakes in the MediaManager source code: 

1. PrintMedia has not been declared abstract. (PrintMedia inherits Media's 
abstract viewMedia() method.) 

2. PrintMedia does not have a PrintMedia (String title) constructor that 
calls its superclass constructor via super (title) ;. 

3. Book does not extend PrintMedia. (A book is a specific kind of print 
media.) 

4. Book's constructor does not call super (title) ; to initialize its super- 
class. 

5. Magazine does not extend PrintMedia. (A magazine is a specific kind of 
print media.) 

6. Magazine does not have a Magazine(String title) constructor that calls 
its superclass constructor via super (title) ;. 

7. Either Book's or Magazine's viewMedia() method should be moved to 
PrintMedia, to factor out commonality. Neither Book nor Media should 
have that method. If done, PrintMedia does not need to be declared 
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abstract, but it is better to leave that class abstract to emphasize print 
media as a generic concept. 

8. Class CDROM does not have a CDROM (String title) constructor that calls 
super (title);. 

9. CDROM does not implement its inherited viewMediaO method. As a 
result, CDROM is abstract and must be declared as such, unless it imple- 
ments ViewMediaO, which it should do. 

10. The CDROM constructor call in main( )'s m array is incorrect. Instead of 
the no-argument constructor, a constructor that initializes a CDROM to a 
specific title is required. 

Here's the corrected MediaManager source code: 
// MediaManager. Java 

abstract class Media 
{ 

private String title; 

Media (String title) 
{ 

this. title = title; 

} 

String getTitle () 
{ 

return title; 

} 



abstract void viewMedia (); 



} 



abstract class PrintMedia extends Media 
{ 

PrintMedia (String title) 
{ 

super (title); 

} 

void viewMedia () 
{ 

System. out. println ("Read by scanning print and images"); 

} 

} 
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class Book extends PrintMedia 
{ 

Book (String title) 
{ 

super (title); 

} 

} 

class Magazine extends PrintMedia 
{ 

Magazine (String title) 
{ 

super (title); 

} 

} 

class CDROM extends Media 
{ 

CDROM (String title) 
{ 

super (title); 

} 

void viewMedia () 
{ 

System. out. println ("Listen to music."); 

} 



class MediaManager 
{ 

public static void main (String [] args) 
{ 

Media [] m = 
{ 

new Book ("Java 2 By Example"), 
new Magazine ( "Time" ) , 
new CDROM ("Music CD") 

}; 

for (int i = 0; i < m. length; i++) 
{ 

System. out. println (m [i].getTitle ()); 
m [i] .viewMedia ( ) ; 

} 

} 

} 
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Independent Exercise 2 

for (int i = 0; i < shapes. length; i++) 
shapes [i] .draw ( ) ; 

Independent Exercise 3 

// MediaManager. Java 

abstract class Media 
{ 

final static int BOOK = 1 ; 
final static int MAGAZINE = 2; 
final static int CDROM = 3; 

private int type; 

private String title; 

Media (int type, String title) 

this. type = type; 
this. title = title; 



nt getType {) 
return type; 



String getTitle () 
return title; 

} 

abstract class PrintMedia extends Media 
{ 

PrintMedia (int type, String title) 
super (type, title); 

} 

class Book extends PrintMedia 
{ 

Book (String title) 
{ 

super (BOOK, title); 
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} 

void readBook () 
{ 

System. out. println ("Read book"); 

} 



class Magazine extends PrintMedia 
{ 

Magazine (String title) 
{ 

super (MAGAZINE, title); 

} 

void readMagazine () 
{ 

System. out. println ("Read magazine"); 

} 



class CDROM extends Media 
{ 

CDROM (String title) 
{ 

super (CDROM, title); 

} 

void listenToCD {) 
{ 

System. out. println ("Listen to music."); 

} 



class MediaManager 
{ 

public static void main (String [] args) 
{ 

Media [] m = 
{ 

new Book ("Java 2 By Example"), 
new Magazine ( "Time" ) , 
new CDROM ("Music CD") 

}; 

for (int i = 0; i < m. length; i++) 
{ 

System. out. println (m [i].getTitle ()); 
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switch (m [i] .getType {)) 
{ 

case Media. BOOK: 

((Book) m [i] ) . readBook (); 
break; 

case Media. MAGAZINE: 

((Magazine) n [i] ) . readMagazine () 
break; 

case Media. CDROM: 

((CDROM) n [i]).listenToCD (); 



Answers to Chapter 8 




REVIEW 



Reviewing It 



1. If you have a class named iterator that's declared in a class named 
Spreadsheet, the compiler chooses Spreadsheet$lterator as the name of 
the class file containing Iterator. 

2. The mark and sweep garbage collector algorithm works in two phases. 
In the mark phase, the algorithm traverses a tree of references and 
marks each encountered object. In the sweep phase, unmarked objects 
are freed, and their memory is reclaimed for use in future objects. As 
far as the JVM is concerned, object finalization must be part of the 
sweep phase. 

3. Local inner classes and anonymous inner classes cannot access nonfi- 
nal parameters or local variables in the immediately enclosing scope 
because Java cannot guarantee that there will not be corruption to the 
variable's value if two threads simultaneously refer to that variable. 



CHECK 



Cliecl<ing It 



Multiple Choice 

1. b 

2. a 

3. c 
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4. d 

5. c 

6. d 

7. c 

8. a 

9. b 
10. b 

True or False 

1. False 

2. True 

3. True 

4. False 

5. True 

6. False 

7. False 

8. True 

9. False 
10. False 



Applying It 



Independent Exercise 1 



APPLY // FileOpenClose. java 

class FileOpenClose 
{ 

FileOpenClose (String filename) 
{ 

// Open file here. 

} 

void close () 
{ 

// Close file here. 

} 
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public void finalize () 
{ 

close 0; 

} 



Independent Exercise 2 

// InitOrder. Java 

class Parent 
{ 

int i; 

static int j ; 
{ 

i = 3; 

System. out. println ("parent: i = 3"); 

} 

static 
{ 

i = 2; 

System. out. println ("parent: j = 2"); 

} 



class Child extends Parent 
{ 

int a; 

static int b; 
{ 

a = 10; 

System. out. println ("child: a = 10"); 

} 

static 
{ 

b = 20; 

System. out. println ("child: b = 20"); 

} 



class InitOrder 
{ 
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public static void main (String [] args) 
{ 

new Child (); 

} 



} 



Independent Exercise 3 

// AnonynousDeno. java 

class Base 
{ 

String a = "Fred"; 

} 

class AnonynousDemo 
{ 

public static void main (String [] args) 
{ 

new Base () 
{ 

String a = "Barney" ; 



{ 



System. out. println (a); 
System. out. println (super. a); 



}; 



Answers to Chapter 9 




REVIEW 



Reviewing It 



1. The five exception-handling reserved words are throw, throws, try, 
catch, and finally. 

2. Checked exceptions must be handled because they represent problems 
beyond a program's control (such as attempting to write to a diskette 
that has been removed from a disk drive) that have the potential to 
crash the program (if not handled). In contrast, unchecked exceptions 
are either caused by flawed code (which would never happen in a 
properly designed program) or a JVM-related problem (which is 
beyond the ability of a program to handle). In either case, there is very 
little point in handling an unchecked exception. 
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CHECK 



3. A method that can throw one or more exceptions is declared with a 
Throws clause. However, only those exceptions that are checked need 
have their class names listed in that clause. 

4. You might want to call the no-argument constructor when you are 
more interested in noting that a specific type of exception has occurred 
and not the reason for that exception. 

5. No. When a variable is declared in a Try block, its scope is limited to 
that block. If you need to access that variable from either a Catch 
clause or a Finally clause, declare the variable before the Try state- 
ment. (That is why f is was declared before Try in this chapter's code 
fragments.) 

6. When a Try block that does not throw an exception completes, all sub- 
sequent Catch clauses are skipped. If there is a Finally clause, its 
statements execute. If none of those statements result in an exception 
being thrown, execution continues with the first statement after the 
Finally clause. 

7. Throwable's f illlnStackTrace ( ) method records information about the 
current state of stack frames in the current Throwable object. A refer- 
ence to the object returns, as a Throwable. That method creates a more 
accurate trace of method calls when the same exception is rethrown 
and printStackTrace( ) is called in some target Catch clause to print 
the trace. 



Checking It 



Multiple Choice 



1. 


a 


2. 


c 


3. 


c 


4. 


d 


5. 


c 


6. 


a 


7. 


d 


8. 


b 


9. 


a 


10. 


d 
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True or False 

1. False 

2. True 

3. False 

4. False 

5. True 

6. True 

7. False 

8. True 

9. False 
10. True 



Applying It 



Independent Exercise 1 

APPLY // ArraySize. Java 

class ArraySize 
{ 

public static void main (String [] args) 
{ 

int size = -1 ; 



while (true) 
{ 

try 

char [] c = new char [size]; 
System. out. println (c. length); 
break; 

catch (NegativeArraySizeException e) 
size = 10; 

System. out. println ; 



} 

} 

} 
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Independent Exercise 2 

// CatchMultiple. java 

class CatchMultiple 
{ 

public static void main (String [] args) 
{ 

for (int i = 0; i < 3; i++) 
try 
{ 

switch (i) 
{ 

case 0: int [] x = { '2' }; 

System. out. println (x [-1]); 
break; 

case 1: System. out. println (1 / 0); 
break; 

case 2: new CatchMultiple (). clone (); 

} 

} 

catch (Exception e) 
{ 

if (e instanceof ArraylndexOutOf BoundsException) 
System. out. println ("Bad array index"); 

else 

if (e instanceof ArithmeticException) 

System. out. println ("Attempt to divide by zero"); 

else 

System. out. println ; 

} 

} 

} 

Independent Exercise 3 

// Rethrow. java 

class MyException extends Exception 
{ 

MyException () 
{ 

super ("My exception has been thrown."); 

} 

} 
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class Rethrow 
{ 

public static void main (String [] args) throws MyException 
{ 

try 

{ 

throw new MyException {); 

} 

catch (MyException e) 
{ 

System. out. println ; 

// The following Throw statement throws an exception to 
// the JVM. However, the JVM first ensures the Finally 
// clause executes before it performs a search. Where 
// does this search begin? It begins with the Catch 
// clause associated with the Try-block that calls 
// main() . 

throw e; 

} 

finally 
{ 

System. out. println ("Cleaning up!"); 

} 

} 

} 

Independent Exercise 4 

// ThrowAgain. Java 

class MyException extends Exception 
{ 

MyException () 
{ 

super ( "My Exception" ) ; 

} 

} 

class ThrowAgain 
{ 

public static void main (String [] args) 
{ 

try 
{ 

someMethodi (); 

} 
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catch (MyException e) 
{ 

System. out. println ("nain{) 
e.printStackTrace (); 

} 



" + e.getMessage ( ) ) ; 



} 



static void someMethodI () throws MyException 
{ 

try 
{ 

sonieMethod2 (); 

} 

catch (MyException e) 
{ 

System. out. println ( "soneMethodI ( ) : " + e.getMessage ()); 
e.printStackTrace (); 

throw (MyException) e.filllnStackTrace (); 

} 

} 

static void someMethod2 () throws MyException 
{ 

throw new MyException (); 

} 



} 



What's different in the output between the modified and unmodified 
ThrowAgain apphcations is: mainO's printStackTrace( ) method call (in the 
modified ThrowAgain application) shows the Throw statement's point of ori- 
gin as no longer being in soineMethod2( ). Instead, the point of origin is now 
shown as being in someMethodI ( )'s Catch clause. That is more accurate. 

Why is the (MyException) cast necessary? The f illlnStackTrace( ) method 
returns a Throwable reference, and someMethodI ( )'s throws clause lists 
MyException — not Throwable. It is not possible to list a subclass name in a 
Throws clause of some method and, without a cast, throw that subclass 
object (from that method) by using a superclass reference. 



Answers to Chapter 10 




REVIEW 



Reviewing It 



1. When it comes to pausing threads, it is not a good idea to introduce 
a For loop statement that does nothing. There are several reasons 
against that approach. First, it is difficult to determine the number of 
iterations that correspond to a particular time period. (Does 10,000 
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iterations correspond to 4 seconds?) Second, the chosen number of iter- 
ations might work at one processor speed but won't work at a different 
processor speed. Third, there are other factors (such as number of run- 
ning programs) that will skew the delay period specified by the num- 
ber of iterations. Finally, a thread that attempts to pause by using a 
For loop statement ends up wasting processor cycles. It would be 
better for the processor to stop the thread's execution for a certain 
amount of time so that the processor resource can be used to run 
other threads. 

2. Thread's sleep () methods include millisecond and nanosecond parame- 
ters, even though most platforms that implement a JVM do not 
support that fine-grained resolution, because Java designers will even- 
tually port Java into the embedded device market, where real-time 
millisecond and nanosecond resolutions are common. Before that port- 
ing can take place, many performance-portability issues are being 
addressed. 

In the TimerDemo source code in Listing 10.7, RepeatedTask's run() 
method has a System. exit () method call to terminate the application. 
Even though the main thread has terminated, that method call is 
needed because the timer's non-daemon thread is still running: An 
application will not terminate if at least one non-daemon thread is 
running. 

4. The difference between locks and the waiting and notification mecha- 
nism is: Locks are used to prevent race conditions, and the waiting 
and notification mechanism is used to coordinate the execution of mul- 
tiple threads so that one thread is guaranteed to execute before 
another thread. (Think of the producer-consumer relationship.) 

5. The JLS allows different JVMs to use their own thread-scheduling 
mechanisms so that a JVM implementer can leverage its platform's 
thread scheduling features. Primarily, that has to do with performance 
and flexibility issues. 

6. The System . out . print ( ) and System . out . println ( ) methods are syn- 
chronized to prevent scrambled output. Assuming those methods were 
not synchronized, scrambled output would occur when one thread is 
executing in one of those methods and has output a few characters 
when another thread calls another of those methods to output some 
other characters. Because all characters end up on the same standard 
output device, they would be mixed up. Synchronizing each method 
allows a thread to output all characters before another thread can out- 
put characters. Hence, there is no scrambled output. 
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CHECK 



Checking It 



Multiple Choice 

1. c 

2. d 

3. a 

4. a 

5. b 

6. d 

7. b 

8. d 

9. b 
10. c 



True or False 

1. False 

2. True 

3. False 

4. False 

5. True 

6. False 

7. False 

8. True 

9. True 
10. False 



Applying It 



Independent Exercise 1 



APPLY public static void main (String [] args) 
{ 

System. out. println (Thread. currentThread (j.getName ()); // Output: main 
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Thread. currentThread ().setNane {"abc"); 

System. out. println (Thread. currentThread (j.getNane ()); // Output: abc 

} 

Independent Exercise 2 

// Clock. java 

class Clock 
{ 

public static void main (String [] args) 
{ 

Ticker t = new Ticker (System. currentTimeMillis ()); 
t. start 0; 

} 

} 

class Ticker extends Thread 
{ 

long time = 0; 

Ticker (long time) 
{ 

this. time = time; 

} 

public void run {) 
{ 

while (true) 
{ 

System. out. println (time++); 

try 

{ 

Thread. sleep (1000); 

} 

catch (InterruptedException e) 

{ 

} 

} 

} 

} 

To stop Clock, press Ctrl+C (or your platform's equivalent key combination). 

Independent Exercise 3 

// Clock. java 
class Clock 
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{ 

public static void main (String [] args) 
{ 

Ticker t1 = new Ticker (System. currentTineMillis (), "A"); 
t1 .start 0; 

Ticker t2 = new Ticker (System. currentTimeMillis (), "B"); 
t2. start 0; 

} 

} 

class Ticker extends Thread 
{ 

long time = 0; 

Ticker (long time, String name) 
{ 

this. time = time; 
setName (name); 

} 

public void run () 
{ 

while (true) 
{ 

System. out. println (getName () + ":" + time++); 

try 
{ 

Thread. sleep (1000); 

} 

catch (InterruptedException e) 

{ 

} 



} 



} 



If you call setDaemon(tnue) on each Ticker object before calling that Ticker 
object's start ( ) method, Clock terminates. Once the main thread termi- 
nates, if there are no additional user (that is, non-daemon) threads, the 
JVM automatically terminates the entire application. 

Independent Exercise 4 

The problem with the WierdSyncing source code is the absence of synchro- 
nization, even though a synchronized block is specified in the run( ) method. 
That is due to each thread synchronizing on its own MyThread object lock, 
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where the current MyThread object is identified by this. To achieve synchro- 
nization, both threads must synchronize on the same object's lock. One way 
to achieve that is to specify synchronized (MyThread. class). 



CAUTION 

Because MyThread. class returns the Class object associated with MyThread, the 
MyThread threads are synchronizing on a class \ock. That is legal in an instance 
method (such as run()) as long as the waiting and notification mechanism is not used 
in conjunction with the class lock. Because those methods require an object lock, wait- 
ing and notification mechanism methods will throw IllegalMonitorStateException 
objects if called from a critical section that synchronizes on a class lock. 



Independent Exercise 5 

// DP.java 

class DP 
{ 

public static void main (String [] args) 
{ 

ChopStick cs1 = new ChopStick (); 

ChopStick cs2 = new ChopStick (); 

ChopStick cs3 = new ChopStick (); 

ChopStick cs4 = new ChopStick (); 

ChopStick cs5 = new ChopStick (); 

Philosopher fred = new Philosopher ("fred", cs1, cs5); 
Philosopher john = new Philosopher ("john", cs2, cs1); 
Philosopher alice = new Philosopher ("alice", cs3, cs2); 
Philosopher wanda = new Philosopher ("wanda", cs4, cs3); 
Philosopher pete = new Philosopher ("pete", cs5, cs4); 

fred. start (); 
john. start (); 
alice. start (); 
wanda. start (); 
pete. start (); 

} 



class Philosopher extends Thread 
{ 

private String name; 

private ChopStick left, right; 



Philosopher (String name, ChopStick left, ChopStick right) 
{ 

this. name = name; 
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this. left = left; 
this. right = right; 

} 

public void run () 
{ 

while (true) 
{ 

try 
{ 

System. out. println ("Philosopher " + name + 
" is thinking . " ) ; 

sleep{(int) (100 * Math. random ())); 

System. out. println ("Philosopher " + name + 
" is hungry. " ) ; 

if (left. get (name) < 0) 
{ 

System. out. println ("Philosopher " + name + 
" is dead. " ) ; 

break; 

} 

System. out. println ("Philosopher " + name + 
" got the left fork. " ) ; 

if (right. get (name) < 0) 
{ 

System. out. println ("Philosopher " + name + 
" is dead . " ) ; 

break; 

} 

System. out. println ("Philosopher " + name + 
" got the right fork. " ) ; 

sleep (500); 

System. out. println ("Philosopher " + name + 
" is eating . " ) ; 

sleep ((int) (50 * Math. random ())); 



left. put 0; 

System. out. println ("Philosopher " + name + 

" putting down left fork."); 
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} 

} 



right. put (); 

System. out. println ("Philosopher " + name + 

" putting down right fork."); 

} 

catch (InterruptedException e) {} 

} 



class ChopStick 
{ 

final static boolean USESYNC = true; 



private volatile boolean isTaken = false; 



void put 0 
{ 

if (USESYNC) 

synchronized (this) 
{ 

isTaken = false; 
notify 0; 
return; 

} 

isTaken = false; 

} 

int get (String name) 
{ 

if (USESYNC) 

synchronized (this) 
{ 

long counter = 0; 



while (isTaken) 

if (counter > 450) 
return -1; 

else 

if (++counter > 400) 
{ 

System. out. println ("Philosopher " + name + 
" is starving ! " ) ; 



try 
{ 

wait ( ) ; 

} 
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} 



} 



catch ( InterruptedException e) 

{ 

} 



} 



isTaken = true; 
return 0; 

} 

long counter = 0; 

while (isTaken) 

if (counter > 450) 
return -1; 

else 

if (++counter > 400) 

System. out. println ("Philosopher " + name + 
" is starving ! " ) ; 

isTaken = true; 
return 0; 



DP introduces a usesync constant to facilitate switching between a context 
that can lead to five dead philosophers — deadlock — (when usesync is set to 
false) and a context that allows all philosophers to eat (when usesync is set 
to true). 



Answers to Chapter 11 




REVIEW 



Reviewing It 



1. Another way to implement packages is to use a hierarchical database. 
Within that database, each package name would map to a different 
branch of the hierarchy. 

2. The unnamed package is the default package in which a source file's 
top-level classes and interfaces are placed (in the absence of a package 
directive). Because that package is similar to a single directory, you 
wouldn't want to place all of your program's top-level classes and 
interfaces in the unnamed package, especially if your program consists 
of hundreds of classes and interfaces. (At some point, you'd run into 
name conflicts.) 
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3. Published packages should be given unique package names so they 
can coexist on a platform that requires those packages. For example, 
suppose two vendors create packages called television. (Perhaps those 
vendors are competing in delivering a solution that allows Java pro- 
grams to control digital TV devices.) Assume those packages have 
been installed on a Windows platform, with one package located at 

c: \television and the other package located at c: \packages\television. 
Furthermore, suppose CLASSPATH is set to c : \ ; c : \ packages ; . . In a 
source file, when the compiler encounters import television . * ; , it will 
resolve names from the television package located at c: \television. 
Also, at runtime, the class loader will load class files from c : \ 
television. But what if import television.*; must also import names 
from the package located at c: \packages\television? The CLASSPATH 
environment variable would need to be changed to specify that pack- 
age. But then, it could not locate classes and/or interfaces from the 
previous television package. That problem can become quite 
frustrating. 

4. An Import directive only imports type names from a specific package 
and not also from that package's subpackages to minimize confusion. 
For example, suppose you have two packages: a.b and a.b.c. 
Furthermore, suppose each package contains a different class z. If 
import a.b.*; could import z from both a . b and a.b.c, the compiler 
would be faced with two different packages when trying to identify the 
package to which z in new z ( ) belongs. Would the correct package be 

a . b or a . b . c? In that situation, you would have to specify the correct 
fully qualified package name for each occurrence of z in the source 
file — a tedious task that Import directives are supposed to alleviate. 



Checking It 



Multiple Choice 

1. d 

2. b 

3. a 

4. b 

5. a 

6. c 

7. c 

8. b 
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9. d 

10. d 

True or False 

1. True 

2. False 

3. True 

4. True 

5. False 

6. True 

7. False 

8. False 

9. True 
10. True 



Applying It 



Independent Exercise 1 



APPLY // packagelnfo. Java 

class Packagelnfo 
{ 

public static void main (String [] args) 
{ 

if (args . length != 1 ) 
{ 

System. out. println ("usage: java Packagelnfo packagename" 
return; 

} 

if (args [0]. equals ("all")) 
{ 

Package [] p = Package. getPackages (); 
for (int i = 0; i < p. length; i++) 

System. out. println (p [i].getName ()); 
return; 

} 



Package p = Package. getPackage (args [0]); 
if (p == null) 
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System. out. println ("could not find package " + args [0]); 
return; 



} 



System. out. println 
System. out. println 

System. out. println 

System. out. println 

System. out. println 

System. out. println 

System. out. println 



"Name = " + p.getName ( ) ) ; 

"Implementation title = " + 
p.getlmplementationTitle ()); 

"Implementation vendor = " + 
p.getlmplementationVendor ()); 

"Implementation version = " + 
p.getlmplementationVersion ()); 

"Specification title = " + 
p.getSpecif icationTitle ()); 

"Specification vendor = " + 
p.getSpecif icationVendor ()); 

"Specification version = " + 
p.getSpecif icationVersion ()); 



} 

Independent Exercise 2 

To build graphics, jar, follow the next few steps: 

1. Make sure there is no classpath environment variable. 

2. Create a graphics directory and copy all graphics source files 
(Shape, java, Point, java, Circle, java, Square, java, and Rectangle . j ava) 
into that directory. 

3. Copy UseGraphics . j ava into graphics' parent directory. 

4. Make that parent directory the current directory. 

5. Issue the following command: j avac UseGraphics. java. That command 
will compile UseGraphics. java and all source files in graphics. 

6. To create the JAR, issue the following command: jar cf graphics, jar 
graphics\*. class. A manifest file isn't needed in this example, and we 
only want to place class files in the JAR. (The earlier example that 
created package, jar placed source files and class files in that JAR. The 
source files didn't need to be stored.) 
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Now that you have graphics . j ar, modify CLASSPATH to point to that JAR and 
the current directory For example (under Windows): set classpath= 
graphics .jar;. 

Finally, to run UseTest with the JAR file, issue the following command: java 
UseTest. 



Answers to Chapter 12 




REVIEW 



Reviewing It 



1. string overrides toString( ) so that it returns a reference to the cur- 
rent String object. Code that calls toString( ) can use that reference to 
call String's getChars( ) method to retrieve the array of characters con- 
tained in that String (possibly for printing purposes, which is what the 
System, out. println( St ring s) method ultimately does). In contrast, if 
String did not override toString(), the default inherited toStringO 
method (from Object) would be called, and would return a reference to 
a String object consisting of the following characters: String@xxxxxxxx, 
where each x is a hexadecimal character that contributes to the 
object's hash code. Instead of String s = "abc"; System. out. println 

(s) ; printing abc, Stringgxxxxxxxx would print. 

2. The difference between a string buffer's capacity and length is: 
Capacity refers to the length of the internal array and length refers to 
the number of characters that are actually stored in that array. 

3. String literals are not the only kind of string expressions that can be 
interned: String-valued constant expressions are also interned. For 
example. String si = "abed"; String s2 = "abc" + "d"; 

System. out. println (sl == s2) ; results in true printing. In other 
words, si and s2 refer to the same interned String. 

4. The getNumericValue( ) method returns the integer value of certain 
characters that represent numeric quantities. For example, the Tamil 
symbol represented by character literal ' \u0bf i ' corresponds to 
numeric quantity 100. System. out. println (Character. getNumericValue 
( ' \u0bf 1 ' ) ) ; prints that value. In addition to Tamil symbols, that 
method returns the integer values for certain Roman numerals. 

5. StringTokenizer implements an interface called Enumeration. That 
interface specifies two methods that StringTokenizer must implement: 
hasMoreElements( ) and nextElement( ). Those methods are preferred 
over hasMoreTokens( ) and nextToken() in situations where 
StringTokenizer objects are stored in collections with other objects 
that also implement Enumeration. In that situation, a For loop 
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CHECK 



statement can be used to retrieve each object from the collection. 
Then, for each object, hasMoreElements( ) and nextElement ( ) can be 
called. The resulting code is more compact than if instanceof is 
used to test for a StringTokenizer, and if found, cast that object to a 
StringTokenizer prior to calling its class-specific hasMoreTokens( ) and 
nextToken( ) methods. (The whole idea is to be generic and reduce the 
amount of code that must be specified.) 

6. It is not a good idea to concatenate String objects in a loop because 
concatenation results in the behind-the-scenes creation of StringBuffer 
and String objects that contain the contents of those Strings being con- 
catenated. Depending on the loop's length, many such intermediate 
objects could be created and subsequently destroyed by the garbage 
collector, which would impact a program's performance. 

7. Three ways to convert a StringBuffer to a String are: pass a reference 
to the StringBuffer object to String's String (StringBuffer sb) con- 
structor, call StringBuff er's toString() method, and call String's 
valueOf (Object o) method with a reference to the StringBuffer object 
passed in o. 

8. "abc" .length ( ) is legal for the following reason. The compiler places 
"abc" into a class file's constant pool. When the class file loads, a 
String object containing a, b, and c is created (behind the scenes). The 
b3^ecode instruction that references "abc" is modified to reference that 
String object. Given that String reference, it is legal to call length( ). 



Checking It 



Multiple Choice 

1. c 

2. d 

3. a 

4. c 

5. d 

6. b 

7. b 

8. a 

9. b 
10. a 
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True or False 



False 
True 
False 
True 
False 
False 
True 

8. True 

9. False 
10. True 



1. 
2. 
3. 
4. 
5. 
6. 
7. 



APPLY 



Applying It 



Independent Exercise 1 

// Classify. java 



class Classify 
{ 

public static void main (String [] args) throws java.io.IOException 
{ 

char c = '\u0beb'; // Tamil digit. 



"Character = " + (int) c) ; 
"Defined = " + Character. isDefined ); 
"Digit = " + Character. isDigit ); 
"Ignorable = " + 

Character. isldentifierlgnorable ) ; 
"ISO control = " + Character. isISOControl 
"Java identifier part = " + 
Character. isJavaldentifierPart ) ; 
"Java identifier start = " + 
Character. isJavaldentifierStart ) ; 
"Letter = " + Character. isLetter ); 
"Letter or digit = " + 
Character. isLetterOrDigit ); 
"Lowercase = " + Character. isLowerCase ); 
"Space = " + Character. isSpaceChar ); 
"Titlecase = " + Character. isTitleCase ); 
"Unicode identifier part = " + 



System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 


System 


out 


println ( 
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Character. isUnicodeldentifierPart ) ; 
System. out. println ("Unicode identifier start = " + 

Character. isUnicodeldentifierStart ) ; 
System. out. println ("Uppercase = " + Character. isUpperCase ); 
System. out. println ("White space = " + Character. isWhitespace ); 

byte [] types = 
{ 

Character. COMBINING_SPACING_MARK, 
Character. CONNECTOR_PUNCTUATION, 
Character. CONTROL, 
Character. CURRENCY_SYMBOL, 
Character . DASH_PUNCTUATION , 
Character. DECIMAL_DIGIT_NUMBER, 
Character. ENCL0SING_MARK, 
Character. END_PUNCTUATI0N, 
Character. FORMAT, 
Character. LETTER_NUMBER, 
Character . LlNE_SEPARATOR , 
Character . LOWERCASE_LETTER , 
Character. MATH_SYMBOL, 
Character. MODIFIER_SYMBOL, 
Character. NON_SPACING_MARK, 
Character. OTHER_LETTER, 
Character. OTHER_NUMBER, 
Character. OTHER_PUNCTUATION, 
Character. OTHER_SYMBOL, 
Character. PARAGRAPH_SEPARATOR, 
Character. PRIVATE_USE, 
Character . SPACE_SEPARATOR , 
Character . START_PUNCTUATION , 
Character. SURROGATE, 
Character. TITLECASE_LETTER, 
Character. UNASSIGNED, 
Character. UPPERCASE LETTER 



String [] typeNames = 
{ 

"Combining spacing mark", 
"Connector punctuation", 
"Control" , 
"Currency symbol" , 
"Dash punctuation", 
"Decimal digit number", 
"Enclosing mark" , 
"End punctuation", 
"Format" , 
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"Letter number" , 
"Line separator" , 
"Lowercase letter" , 
"Math symbol" , 
"Modifier symbol" , 
"Non spacing mark" , 
"Other letter" , 
"Other number" , 
"Other punctuation" , 
"Other symbol" , 
"Paragraph separator", 
"Private use" , 
"Space separator" , 
"Start punctuation", 
"Surrogate" , 
"Titlecase letter" , 
"Unassigned" , 
"Uppercase letter" 

}; 

int type = Character. getType ; 

for (int i = 0; i < types . length; i++) 
if (type == types [i] ) 
{ 

System. out. println ("Type name = " + typeNames [i]); 
break; 

} 

System. out. println ("Unicode block = " + 

Character . UnicodeBlock . of ) ; 

} 

} 

Independent Exercise 2 

// Convert. java 

class Convert 
{ 

public static void main (String [] args) 
{ 

// Convert from decimal to hexadecimal. 

int i = 0, num = 23658; 

char [] digits = new char [8]; 



do 
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{ 



digits [i++] = Character. forDigit (nun % 16, 16); 
nun /= 16; 

} 

while (nun != 0) ; 

for (int j = 7; i >= 0; j --) 

System. out. print (digits [j]); 

System. out. print ("\n"); 

// Convert from hexadecimal to decimal. 

char [] hex = { 'f ' , '3' , '6' , '0' }; 
num = 0; 

for (int j = 0; i < hex. length; ]++) 
{ 

num «= 4; // equivalent (but faster than) num *= 16; 
num += Character. digit (hex [j], 16); 

} 

System. out. println (num); 



Independent Exercise 3 

string s = "Able was I ere I saw Elba!"; 
String prefix = "Able was"; 

boolean match = true; // Assume s begins with prefix. 

if (prefix. length () <= s. length ()) 

for (int i = 0; i < prefix. length (); i++) 
if (s.charAt (i) != prefix. charAt (i)) 
{ 

match = false; 
break; 

} 

if (match) 

System. out. println (s + " begins with " + prefix); 

Independent Exercise 4 

// STDemo.java 
import java.util.*; 



} 



} 



class STDemo 
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public static void main (String [] args) 
{ 

StringTokenizer st = new StringTokenizer ("The quick brown " + 

"fox jumps over " + 
"the lazy dog. " ) ; 

while (st.hasMoreTokens ()) 

System. out. println (st . nextToken ()); 



} 



Independent Exercise 5 

// MorseCode. Java 

import i ava . util . StringTokenizer ; 

class MorseCode 
{ 

static String [] digit_dashes_dots 
{ 

// 0 



// 9 



}; 



static String [] letter_dashes_dots 
{ 

//A 



J 
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// z 



}; 



public static void main (String [] args) 
{ 

String message = "The quick brown fox jumped over the lazy dog"; 

// If at least one command line argument is specified, use this 
// argument as the message. 

if (args. length >= 1 ) 
message = args [0] ; 

String morse_code = convertToMorseCode (message); 
System. out. println (morse_code) ; 

System. out. println (convertFromMorseCode (morse_code) ) ; 

} 

public static String convertFromMorseCode (String code) 
{ 

StringBuffer sb = new StringBuffer (200); 
StringTokenizer st = new StringTokenizer (code); 

next_token : 

while (st.hasMoreTokens ()) 
{ 

String token = st.nextToken (); 



for (int i = 0; i < digit_dashes_dots. length; i++) 
if (token. equals (digit_dashes_dots [i])) 
{ 

sb. append ( (char) ( '0' + i) ) ; 
continue next_token; 

} 
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for (int i = 0; i < letter_dashes_dots. length; i++) 
if (token. equals (letter_dashes_dots [i])) 
{ 

sb. append ( (char) ( 'A' + i) ) ; 
break; 

} 



return sb.toString ( ) ; 



} 



public static String convertToMorseCode (String nsg) 
{ 

StringBuffer sb = new StringBuffer (200); 
char c; 

for (int i = 0; i < msg. length (); i++) 
{ 

c = Character. toUpperCase (msg.charAt (i)); 

if (Character. isDigit ) 

sb. append (digit_dashes_dots [c - '0'] + " "); 
else 

if (Character. isLetter ) 

sb. append (letter_dashes_dots [c - 'A'] + " "); 



return sb.toString ( ) ; 



} 



} 



To run MorseCode from the command line, type Java MorseCode. That com- 
mand line results in the message The quick brown fox jumped over the lazy 
dog . being converted to Morse code. However, you can use MorseCode to con- 
vert any message, by specifying the message as an argument to MorseCode. 
For example: java MorseCode "Hello World". 



Answers to Chapter 13 




REVIEW 



Reviewing It 



1. Three benefits to a collections framework are reduction in program- 
ming effort (by allowing developers to focus on their programs and not 
on developing collections classes), reuse (by providing a consistent set 
of interfaces), and improved program performance (by making it easy 
to choose the right implementation from a group of related implemen- 
tations). 



20 71710_APP A 11/21/01 3:53 PM Page 760 




760 Appendix A 



2. Hashtable, Stack, and Vector methods are synchronized to allow their 
respective objects to be thread-safe. 

3. One circumstance in which an UnsupportedOperationException object 
would be thrown is an attempt to modify an immutable collection. For 
example, calls to the Collection interface's add() and remove () methods 
on an immutable collection would result in the aforementioned excep- 
tion being thrown. The reason: Those methods would attempt to 
change an unchangeable (immutable) collection. 

4. Two main differences between a Properties object and a Hashtable 
object are the kinds of objects stored and whether or not the 
Properties/Hashtable objects are capable of saving stored objects and 
later loading those objects. Hashtable objects store any kind of objects 
but do not "know" how to save stored objects and load saved objects. In 
contrast. Properties objects, though capable of storing any kind of 
objects, are supposed to store only string objects. Also, Properties 
objects "know" how to save stored objects and load saved objects. 

5. SortedList is probably not included in the Collections API because Sun 
might have felt that it did not make sense to include that interface 
under the current interface hierarchy. If you look closely at the hierar- 
chy, you see SortedSet extending Set and SortedMap extending Map. For 
symmetry (and to differentiate between sorted and unsorted), it would 
seem to make sense for SortedList to extend List. After all, a list is 
either sorted or unsorted, and a sorted list is a kind of list. Suppose 
SortedList was introduced and extended List. Look closely at List, and 
you'll see a method called set(int index, Object o). Calling that 
method would make it possible to change the sorted order to unsorted 
order by replacing objects at various locations with other objects. 
However, because List's set( ) method is described as optional in the 
Collections API documentation, the preceding problem could be solved 
by having set() throw an UnsupportedOperationException object. Unless 
there is some other significant reason for not including SortedList, 
maybe that interface and an appropriate SortedList class (that uses an 
internal linked list and an insertion sort technique to maintain that 
list's nodes in sorted order, by inserting nodes in the right place) will 
find its way into a future release of the Collections API. 



Checking It 



Multiple Choice 

CHECK 

1. C 

2. b 
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3. a 

4. d 

5. d 

6. b 

7. a 

8. c 

9. a 
10. b 

True or False 

1. False 

2. True 

3. True 

4. False 

5. False 

6. True 

7. False 

8. True 

9. False 
10. False 



APPLY 



Applying It 



Independent Exercise 1 

int [][][] X = 
{ 



{ 



{1,2}, 
{ 3, 4 }, 
{ 5, 6 } 



{ 

{ 7, 8, 9 }, 
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{ 1> 2, 3 } 

} 

}; 

// Return number of tables. 

System. out. println (x. length); 

// Return number of rows in first table. 

System. out. println (x [0]. length); 

// Print value at row 0, column 1 in second table. 

System. out. println (x [1][0][1]); 

Independent Exercise 2 

void dump (int [][][] array) 
{ 

for (int table = 0; table < array. length; table++) 
{ 

for (int row = 0; row < array [table] .length; row++) 
{ 

for (int col = 0; col < array [table] [row] .length; col++) 
System. out. print (array [table] [row] [col] + " "); 

System. out. println (""); 

} 

System. out. println (""); 

} 

} 

Independent Exercise 3 

Properties p = System. getProperties (); 
System. out. println (p.getProperty ( "os. name" ) ) ; 

Independent Exercise 4 

// QueueDemo. java 

import java.util.*; 

class Queue extends Vector 
{ 

void insertAtTail (Object o) 
{ 
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addElement (o); 

} 

Object removeFromHead () 
{ 

Object 0 = firstElement (); 
removeElenent (o); 

return o; 

} 

} 

class OueueDeno 
{ 

public static void main (String [] args) 
{ 

Oueue q = new Queue ( ) ; 

q.insertAtTail (new Integer (-5)); 
q.insertAtTail (new Double (1.0)); 
q.insertAtTail ("John Doe"); 

while ( Iq.isEmpty ()) 

System. out. println (q . removeFromHead ()); 

} 

} 

Independent Exercise 5 

Set s = new TreeSet ( ) ; 
s.add ("first"); 
s.add ("second"); 
s.add ("third"); 

List 1 = new ArrayList (s); 

Iterator i = 1. iterator (); 
while (i.hasNext ()) 

System. out. println (i.next ()); 

Independent Exercise 6 

// Search. java 

import java.util.*; 

class Search 
{ 

public static void main (String [] args) 
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String [] countries = 
{ 

"Ecuador" , 
"Venezuela" , 
"Argentina" , 
"Brazil" , 
"Chile" 

}; 

List 1 = new ArrayList (); 
for (int i = 0; i < countries. length; i++) 
l.add (countries [i]); 

Collections . sort (1); 

int index = Collections. binarySearch (1, "Venezuela"); 
if (index < 0) 

System. out. println ("Not found"); 

else 

System. out. println ("Found " + l.get (index)); 



Answers to Chapter 14 




REVIEW 



Reviewing It 



1. Chapter I's Craps application calls Math, random ( ) to return pseudoran- 
dom numbers for each of two dice. Because the same sequence is being 
used for each die, a roll of the dice is not as random as it could be. 

2. It is beneficial to reproduce the same sequence of pseudorandom num- 
bers for debugging purposes. For example, if you are testing a mal- 
functioning game, you will want to locate the source of the 
malfunction. If that malfunction occurs when a particular sequence of 
pseudorandom numbers is generated and you aren't able to reproduce 
that sequence, it will be much harder to track down the cause of the 
malfunction. 

3. You might want to work directly with hexadecimal integer literals 
instead of decimal integer literals to enhance source code readability 
when working at the bit level. For example, if you are writing code 
that manipulates an image's bits, it is often easier to understand what 
is happening when you express integers as hexadecimal literals. 



20 71710_APP A 11/21/01 3:53 PM Page 765 




CHECK 



Appendix A 765 



4. BigDecimal bd = new BigDecimal (123.455); bd = bd.setScale (2, 
BigDecimal.ROUND_HALF_UP) ; System . out . println (bd.toString ()); 
results in 123. 45 printing instead of (the correct) 1 23 . 46 because 
1 23 . 455 cannot be represented exactly as a double-precision floating- 
point number. However, if the BigDecimal (St ring value) constructor is 
used, 1 23 . 455 is represented accurately as integer 123455 and scale 
3 — and results in 123.455 being correctly rounded to 123.46. 



Checking It 



Multiple Choice 

1. a 

2. b 

3. d 

4. d 

5. a 

6. c 

7. b 

8. c 

9. b 
10. a 

True or False 



1. 


False 


2. 


True 


3. 


True 


4. 


False 


5. 


False 


6. 


False 


7. 


True 


8. 


True 


9. 


False 


10. 


True 
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Applying It 



Independent Exercise 1 



APPLY double smallestDouble (double x, double y, double z) 
{ 

return Math.min (Math.min (x, y), z); 

} 

Independent Exercise 2 

double cube (double x) 
{ 

return Math.pow (x, 3.0); 

} 

Independent Exercise 3 

a. (int) (Math. random () * 3) - 1 

b. (int) (Math . random () * 1000) 
C. (int) (Math . random( ) * 9) - 9 

Independent Exercise 4 

double X = 1 .5463; 

System. out. println (Math. floor (x * 10 + 0.5) / 10); // Tenths 

System. out. println (Math. floor (x * 100 + 0.5) / 100); // Hundredths 

System. out. println (Math. floor (x * 1000 + 0.5) / 1000); // Thousandths 

Independent Exercise 5 

Biglnteger bi = new Biglnteger ("-129"); 
int length = bi.bitLength (); 
for (int i = length; i >= 0; i--) 

System. out. print (bi.testBit (i) ? '1' : '0'); 

Independent Exercise 6 

Biglnteger bi = new Biglnteger ("-129"); 
System. out. println (bi.signun ()); 
System. out. println (bi.toString (16)); 

Independent Exercise 7 

// Guess. java 
import java.io.*; 



class Guess 
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{ 

public static void main (String [] args) throws lOException 
{ 

// Generate a random number between 65 and 90 inclusive. 
// This number represents the Unicode value for a hidden 
// letter. 

int hiddenLetter = 'A' + (int) (Math. random () * 26); 

boolean guessedCorrectly = false; 

// Try to guess the number. 

while ( IguessedCorrectly) 
{ 

System. out. print ("Guess a hidden letter, between A and Z:"); 

// The following method reads one or more characters from the 

// keyboard. These characters are placed into a buffer. The 

// user must press the Enter key to terminate input. Pressing 

// Enter causes a carriage return character followed by a 

// newline character to be placed in the buffer. 

int guessedChar = System. in. read (); 

// Advance to the next output line, to prevent messy output. 
System. out. println (); 

// If Enter was pressed by itself (indicated by the carriage 
// return character), try again. 

if (guessedChar == ' \r' ) 
{ 

// Skip over the newline character that follows carriage 
// return. 

System. in. read (); 
continue; 

} 

// Remove remaining characters (including carriage return and 
// newline) from the buffer. 



while (System. in. read () != '\n'); 
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// Check character to see if it's less than, greater than, or 
// equal to the hidden character. 

if (guessedChar < hiddenLetter) 

System. out. println ("Guessed too low!"); 

else 

if (guessedChar > hiddenLetter) 

System. out. println ("Guessed too high!"); 

else 
{ 

System. out. println ("You guessed correctly!"); 
guessedCorrectly = true; 

} 

} 

} 

} 




REVIEW 



Answers to Chapter 15 



Reviewing It 



1. A pathname violates portability if it includes a hard-coded platform- 
specific prefix and/or a hard-coded platform-specific directory name 
separator character. For example, "c:temp\x" violates portability 
because it includes the Windows c : drive specifier prefix and the 
Windows \ directory name separator character. 

2. Java locates the default temporary data file directory by reading the 
value of the java.io.tmpdir system property. 

3. The difference between the FileFilter and FilenameFilter interfaces 
is: FileFilter declares an accept ( ) method that takes a single File 
argument, whose abstract pathname identifies one or more directories 
and a filename, whereas FilenameFilter declares an accept () method 
that takes a File argument, whose abstract pathname identifies one or 
more directories, and a String argument that identifies the file's name. 
Either accept ( ) method returns true if the filename passes through 
the filter (that is, it is accepted). 

4. The purpose of RandomAccessFile's getFD( ) method is to return a 
FileDescriptor object reference. The FileDescriptor object represents 
an opaque Chidden) handle to an underlying platform-specific struc- 
ture representing an open file. You can pass the FileDescriptor object 
reference to an appropriate constructor for any of the file stream 
classes, which connects an open random-access file to an appropriate 
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file stream. That allows you to connect multiple file streams to the 
same random-access file. 

5. The purpose of the inputStreamReader and OutputStneamWriter classes is 
to serve as bridges fi^om byte-oriented streams to character-oriented 
streams and fi"om character-oriented streams to byte-oriented 
streams, respectively. For example, a FileReader object is a kind of 
InputStreamReader object that reads bytes from an underlying 
FilelnputStream and converts them to a stream of characters. 
Similarly, a FileWriter object is a kind of OutputStreamWriter object 
that converts characters to a stream of bytes that it writes to an 
underlying FileOutputStream. 

6. When an object deserializes, static fields are not modified: They 
contain their most recent values. That is due to static fields having 
nothing to do with an object. 

7. When an object is created from a class whose superclass implements 
the Serializable interface and you do not want that object to be serial- 
ized, you can prevent serialization by implementing the private void 
writeOb]ect(ObjectOutputStream oos) method in that object's class and 
having that method throw a NotSerializableException object. The 
exception is caught by ObjectOutputStream's writeObject (Object o) 
method, which aborts the serialization process when it detects that 
exception. 

8. You would use StreamTokenizer's pushBack( ) method when you are try- 
ing to differentiate between several token sequences that begin with 
the same token. For example, while reading text, you encounter a 
token consisting of a single asterisk character. That asterisk character 
can represent a multiplication operator symbol, or it can signal the 
beginning of two consecutive asterisks that represent an exponentia- 
tion operator symbol. You cannot assume multiplication until you have 
verified than the next token is not also an asterisk. If it is not an 
asterisk, you must call pushBack( ) because you have read one token too 
far. If you do not call pushBack( ), the next read token will be the sec- 
ond token that follows the single asterisk character token, and not the 
first token that follows that character. 



Checking It 



Multiple Choice 

CHECK ^ ^ 

2. C 
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3. a 

4. b 

5. d 

6. a 

7. c 

8. d 

9. b 
10. a 

True or False 

1. False 

2. True 

3. False 

4. False 

5. True 

6. False 

7. True 

8. True 

9. False 
10. False 



Applying It 



Independent Exercise 1 



APPLY File. separator + "temp" + File . separator + "a.dat" 

Independent Exercise 2 

// Dir.java 

import java.io.*; 

class Dir 
{ 

public static void main (String [] args) 
{ 
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String [] pathnames = new File ("."). list (); 
for (int i = 0; i < pathnames. length; i++) 
System. out. println (pathnames [i]); 

} 

} 

Independent Exercise 3 

// Dir.java 

import java.io.*; 

class Dir implements FileFilter 
{ 

static String ext = "*" ; 

public static void main (String [] args) 
{ 

if (args . length == 1 ) 
ext = args [0] ; 

else 

if (args . length > 1 ) 
{ 

System. err. println ("usage: java Dir ext"); 
return; 

} 

File [] pathnames = new File {"."). listFiles (new Dir ()); 
for (int i = 0; i < pathnames. length; i++) 

System. out. println (pathnames [i].getName ()); 

} 

public boolean accept (File pathname) 
{ 

if (ext. equals {"*")) 
return true; 

return pathname. getName ().endsWith (ext) ? true : false; 

} 

} 

Independent Exercise 4 

// Touch. java 
import java.io.*; 



class Touch 
{ 
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public static void main (String [] args) 
{ 

String dirname = " . " ; 

if (args . length == 1 ) 
dirname = args [0] ; 

else 

if (args . length > 1 ) 
{ 

System. err. println ("usage: java Touch pathname" 
return; 

} 

File dir = new File (dirname); 
if ( Idir.isDirectory ()) 
{ 

System. err. println ("directory expected"); 
return; 

} 

String [] names = dir. list {); 

long currentTime = System. currentTimeMillis (); 

for (int i = 0; i < names . length; i++) 
{ 

File f = new File (dir, names [i]); 
f . setLastModif led (currentTime); 

} 



Independent Exercise 5 

// SAFFDBDemo. java 
import java.io.*; 



class SAFFDBDemo 
{ 

public static void main (String [] args) 
{ 

String [] months = 
{ 

"January", "February", "March", "April", "May", "June", 

"July", "August", "September", "October", "November", "December" 

}; 
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int [] days = 
{ 

31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 

}; 

DataOutputStream dos = null; 

try 
{ 

FileOutputStream fos = new FileOutputStream { "months. dat" ) ; 
dos = new DataOutputStream (fos); 



for {int i = 0; i < months. length; i++) 
{ 

dos.writeUTF (months [i]); 
dos.writeint (days [i]); 

} 

} 

catch (lOException e) 
{ 

System. out. println (e.getlHessage ()); 
return; 

} 

finally 
{ 

if (dos != null) 
try 
{ 

dos. close 0; 

} 

catch (lOException e) 

{ 

} 

} 



DatalnputStream dis = null; 



try 
{ 

FilelnputStream fis = new FilelnputStream ("months.dat"); 
dis = new DatalnputStream (fis); 



while (true) 

System. out. println (dis.readUTF () + " " + dis.readint ()); 

} 

catch (lOException e) 
{ 
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if (e instanceof EOFException) 
return; 



System. out. println (e.getMessage ()); 

} 

finally 
{ 

if (dis != null) 
try 
{ 

dis. close (); 

} 

catch (lOException e) 

{ 

} 

} 

} 

} 

Independent Exercise 6 

// LineViewer. Java 

import java.io.*; 

class LineViewer 
{ 

public static void main (String [] args) 
{ 

if (args . length != 1 ) 
{ 

System. err. println ("usage: java LineViewer pathname"); 
return; 

} 



LineNumberReader Inr = null; 



try 
{ 

FileReader fr = new FileReader (args [0]); 
Inr = new LineNumberReader (fr); 



String s; 

while ((s = Inr.readLine ()) != null) 

System. out. println (Inr.getLineNumber () + ": " + s); 

} 

catch (lOException e) 
{ 
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System. err. println (e.getMessage ()); 

} 

finally 
{ 

if (Inr != null) 
try 
{ 

Inr. close (); 

} 

catch (lOException e) 

{ 

} 

} 



} 



Independent Exercise 7 

// ZipReader. Java 

import java.io.*; 
import java.util.Date; 
import iava.util.zip.*; 

class ZipReader 
{ 

public static void main (String [] args) 
{ 

if (args. length != 1 ) 
{ 

System. out. println ("usage: java ZipReader pathname"); 
return; 

} 

ZipInputStream zis = null; 

try 
{ 

FilelnputStream fis = new FilelnputStream (args [0]); 
zis = new ZipInputStream (fis); 

ZipEntry ze; 

while ((ze = zis.getNextEntry ()) != null) 
System. out. println (ze.getName () + " [" + 
ze.getSize () + "] [" + 
new Date (ze.getTime ()).toString () + 

"]"); 
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} 

catch (lOException e) 
{ 

System. out. println (e.getMessage ()); 

} 

finally 
{ 

try 

zis. close 0; 
catch (lOException e) 



} 

} 

} 

Independent Exercise 8 

// Multiply. java 

import java.io.*; 

class Multiply 
{ 

public static void main (String [] args) 
{ 

System. out. print ("Enter first number: "); 
double num1 = getDouble (); 

System. out. print ("Enter second number: "); 
double num2 = getDouble (); 

System. out. println ("Product = " + num1 * num2); 

} 

static double getDouble () 
{ 

StringBuffer sb = new StringBuffer (); 
int ch = 0, i = 0; 

do 

{ 

try 
{ 

oh = System. in . read ( ) ; 



20 71710_APP A 11/21/01 3:53 PM Page 777 




Appendix A 777 



if (ch == '\r') 

ch = System. in. read (); 

if (ch == ' \r ' II ch == ' \n ' ) 
break; 

sb. append ((char) ch); 

} 

catch (iava.io.IOException e) 

{ 

} 

} 

while (true); 

return Double. parseDouble (sb.toString ()); 

} 

} 

Independent Exercise 9 

// SDVector. java 

import java.io.*; 
import java.util.*; 

class SDVector implements Serializable 
{ 

public static void main (String [] args) 
{ 

Vector V = new Vector (); 

v.addElement (new Character ('§')); 

v.addElement (new Random ()); 

V.addElement ("This is a string."); 

V.addElement (new Date ()); 

V.addElement (new Integer (62)); 

V.addElement (new SDVector {)); 

ObjectOutputStream oos = null; 

try 
{ 

FileOutputStream fos = new FileOutputStream ("v.ser"); 
oos = new ObjectOutputStream (fos); 



oos.writeObject (v); 

} 

catch (Exception e) 
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System. out. println ; 
return; 

} 

finally 
{ 

if (oos != null) 
try 

oos. close (); 
catch (lOException e) 



ObjectlnputStream ois = null; 



try 
{ 

FilelnputStream fis = new FilelnputStream ("v.ser"); 
ois = new ObjectlnputStream (fis); 

Vector v2 = (Vector) ois. readObject (); 

Enumeration e = v2. elements (); 
while (e.hasMoreElements ()) 

System. out. println (e.nextElement ()); 

} 

catch (Exception e) 
{ 

System. out. println ; 
return; 

} 

finally 
{ 

if (ois != null) 
try 

ois. close 0; 
catch (lOException e) 



} 

} 

} 



20 71710_APP A 11/21/01 3:53 PM Page 779 




Appendix A 779 



Independent Exercise 10 

// ExtractTokens.java 

import java.io.*; 

class ExtractTokens 
{ 

public static void main (String [] args) 
{ 

if (args . length != 1 ) 
{ 

System. err. println ("usage: java ExtractTokens filename"); 
return; 

} 

FileReader fr = null; 

try 
{ 

fr = new FileReader (args [0]); 

StreamTokenizer st = new StreamTokenizer (fr); 
st.lowerCaseMode (true); 

while (st . nextToken () != StreamTokenizer. TT_EOF) 
{ 

switch (st.ttype) 
{ 

case ' \ ' ' : 
case ' " ' : 

System. out. println ("String = " + st.sval); 
break; 

case StreamTokenizer. TT_EOL: 

System. out .println ( "End -of -line" ) ; 
break; 

case StreamTokenizer. TT_NUMBER: 

System. out. println ("Number = " -i- st.nval); 
break; 

case StreamTokenizer. TT_WORD: 

System. out. println ("Word = " -i- st.sval); 
break; 

default: 

System. out. println ("Other = " -i- (char) st.ttype); 
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} 

} 

} 

catch (FileNotFoundException e) 
{ 

System. out. println ("Cannot find file " + args [0]); 

} 

catch (lOException e) 
{ 

System. out. println ; 

} 

finally 
{ 

if (fr != null) 
try 
{ 

fr. close 0; 

} 

catch (lOException e) 

{ 

} 

} 
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■4 

B 



Reserved Words 

Reserved words are part of the Java language syntax. They cannot be used 
as names for variables, methods, classes, interfaces, packages, or labels. 
Table B.l lists Java's 52 reserved words. 



Table B.l 


Reserved Words 








abstract 


assert 


boolean 


break 


byte 


case 


catch 


char 


class 


const 


continue 


default 


do 


double 


else 


extends 


false 


final 


finally 


float 


for 


goto 


if 


implements 


import 


instanceof 


int 


interface 


long 


native 


new 


null 


package 


private 


protected 


public 


return 


short 


static 


strictf p 


super 


switch 


synchronized 


this 


throw 


throws 


transient 


true 


try 


void 


volatile 


while 









Java does not currently implement const and goto. Furthermore, except for 
false, null, and true, all reserved words are also known as keywords, 
(false, null, and true are known as literals.) 



CAUTION 

Because Java is case-sensitive, it is possible to change the case of at least one letter 
in a reserved word and then use the result to name a variable, a method, and so forth. 
For example, once you uppercase letter c in case, you can use the result — Case — in 
your source code. However, that is a very bad idea in terms of human readability. For 
the sake of clarity, avoid that practice. 
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1.4 



NEW 




EXAMPLE 



Assertions 



A close look at Table B.l reveals the presence of keyword assert. That key- 
word allows you to introduce assertions into source code. What are asser- 
tions? An assertion is an assumption about program behavior. That 
assumption is expressed as a statement containing a Boolean expression 
believed to be true when that statement executes. At runtime, the JVM 
evaluates that expression. If false returns (which indicates an incorrect 
assumption), the assertion creates an object from the AssertionError class 
(located in the java.lang package) and throws that object to the JVM. If 
true returns (which indicates a correct assumption), however, the JVM exe- 
cutes the first statement following the assertion, and the program contin- 
ues. You can express an assertion in source code by using the following 
syntax: 

'assert' expression ';' 

An assertion begins with the assert keyword. Following assert is a Boolean 
expression and a semicolon. 

Assertions are often needed to validate assumptions made about chained If- 
Else and Switch decision statements. With either decision statement, there 
might be situations where you feel you do not need a final else or a default 
case. You might feel that way because all possible decisions (expressed as 
Boolean expressions) are considered (or so you think). On the outside 
chance that none of the Boolean expressions return true (which indicates 
the need for a final else or default case), you can use an assertion to tell 
yourself that something has gone wrong with your program and that your 
source code needs adjustment. Listing B.l's AssertDemo source code demon- 
strates: 

Listing B.l: AssertDemo. Java. 
// AssertDemo. Java 

class AssertDemo 
{ 

public static void main (String [] args) throws java.io.IOException 
{ 

System. out. print ("Please type Y or N and press ENTER:"); 
int choice = System. in. read (); 



if (choice == 'y' ) 
choice = ' Y' ; 



if (choice == 'n' ) 
choice = 'N' ; 
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Listing B.l: continued 

message (choice); 

} 

static void message (int choice) 
{ 

switch (choice) 
{ 

case 'Y': System. out. println ("Yes"); 

// Do something significant in Yes case, 
break; 

case 'N': System. out. println ("No"); 

// Do something significant in No case, 
break; 

default : assert (choice 'Y' || choice 'N'); 

} 

} 

} 

AssertDemo demonstrates a situation in which you might think only two Y or 
N choices need to be tested. The idea is that the program must react in one 
of two ways, and there is no need for a third alternative. To obtain the 
choice, a call is made to System . in . read ( ) . Following that method call, code 
should be specified to validate that only Y or N was entered. As you can 
see, validation code is specified to map y to Y and n to N. However, valida- 
tion code is missing that ensures only Y or N was entered. The presence of 
a default case with the assert (choice == 'Y' || choice == 'N'); state- 
ment alerts the developer to the fact that message ( ) can be called with a 
choice argument value that does not represent Y or N. The developer can 
then introduce additional validation code that ensures message ( ) is called 
with only a choice argument value that represents Y or N (and nothing else). 

Introducing a new keyword into an established language runs the risk of 
breaking code that uses that keyword to name a field, a method, or some- 
thing else. Undoubtedly, Java source code exists that already includes 
assert for some such purpose. To deal with that situation. Sun defaults both 
its compiler and application launcher programs to ignore assert as a key- 
word. As a result, legacy Java source code that uses assert as the name of a 
method (or something else) compiles and runs with no problems. If you 
want to use assert in its new assertion role, you must take advantage of 
certain new options when compiling and running your program. Those 
options include -source 1 .4 for the compiler and -ea (or -enableassertions) 
for the application launcher. Issue the following commands with the afore- 
mentioned options to compile AssertionDemo. java and run 
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Assert ionDemo . class: 

javac -source 1.4 AssertDemo. java. 
java -ea AssertDemo 

When you run AssertDemo, enter Y, y, N, n, and k — and see what happens 
when you enter k. 

NOTE 

I've shown you a small taste for assertions. To keep the discussion simple, I've left out 
a lot of detail. I encourage you to review Sun's documentation on assertions (and get 
that detail) by "surfing" to http: // java. sun. com/i2se/1 .4/clocs/guide/lang/ 
assert . html. 



71710_APP B 11/21/01 3:09 PM Page 787 



22 71710_APP C 11/21/01 3:11 PM Page 788 




:11 PM Page 789 




c 



Operator Precedence 



Table C.l lists Java's 42 operators (based on the Java Language 
Specification) in decreasing order of precedence. Operators with the 
same precedence are grouped together and separated from other groups 
by horizontal lines. 

Table C.l: Operator Precedence 



Operator 



Description 



(typeldentifier) 



postincrement 
postdecrement 
preincrement 
predecrement 
unary plus 

unary minus (negation) 
logical complement 
bitwise complement 
cast 



multiplication 

division 

remainder 



+ 



addition/ string concatenation 
subtraction 
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Table C.l: continued 



Operator Description 

« left shift 

» signed riglit sliift 

»> unsigned riglit sliift 



< relational less than 

<= relational less than or equal to 

> relational greater than 

>= relational greater than or equal to 

instanceof relational type checking 



equal to 
not equal to 



bitwise/logical AND 



bitwise/logical exclusive OR 



bitwise/logical inclusive OR 



&& conditional AND 



conditional OR 



conditional 



simple assignment 
+= compound assignment 

compound assignment 
*= compound assignment 

/= compound assignment 
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Table C.l: continued 



Operator 



Description 



compound assignment 
compound assignment 
compound assignment 
compound assignment 
compound assignment 
compound assignment 
compound assignment 
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Additional Resources 

This book teaches many things about Java. However, it is not possible for 
any one book to provide you with every last piece of information about this 
technology. Therefore, this appendix provides a list of additional resources 
to supplement this book's content. These resources cover a range of topics, 
from how to become a certified Java developer to where to find answers to 
your questions, as well as where to find tutorials and articles that further 
expand on your Java knowledge. 
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Certification 



If you want to get a good job with Java technology, you can improve your 
chances by obtaining certification. Companies prefer developers who have 
this designation to those who do not. (It's analogous to having a degree in 
Computer Science.) Consider seeking certification after working your way 
through this book. 

Sun Microsystems offers three levels of certification: Sun Certified 
Programmer for the Java Platform, Sun Certified Developer for the 
Java Platform, and Sun Certified Enterprise Architect for Java 2 
Platform, Enterprise Edition Technology. To learn about these levels 
of certification, visit the certification section of the Sun Educational 
Services Web site at http: //suned. sun. com/HQ/certification/. 

NOTE 

Because this book focuses on Java 2 Platform Standard Edition (and not Enterprise 
Edition), you should obtain another book that explores Enterprise Edition before seeking 
the Sun Certified Enterprise Architect for Java 2 Platform, Enterprise Edition Technology 
designation (if becoming an enterprise architect is your goal). One Enterprise Edition 
book to consider is Que's Special Edition Using Java 2 Enterprise Edition (by Mark 
Wutka). 

At this point, you might be wondering whether or not certification is worth- 
while. To clear up any doubts you might have, visit EarthWeb's three-part 
Why Certify? column (by David Fisco): 

Part 1 explores the value of Sun's Programmer's Certification for the 
Java 2 platform and is located at http: //sof twaredev.earthweb.com/ 
iava/article/0, , 12082_600641 ,00. html. 

Part 2 looks at how to prepare for the certification exam and is located 
at http: //softwaredev.earthweb.com/iava/article/0, , 12082_ 
727361 ,00. html. 

Part 3 is not yet written (at least not written when this book was writ- 
ten). However, based on Part 2's conclusion, David plans (in Part 3) to 
interview people outside of Sun for their take on the value of 
certification. 



FAQs, Forums, and Newsgroups 



Questions, questions, questions! Where are the answers? You can start 
searching for those answers by examining Web sites containing Frequently 
Asked Questions (FAQs). For example. Sun's Java Developer 
Connection Web site (http: / /developer, java. sun . com/developer /techDocs/ 
faqs.html) provides a list of links to FAQs ranging from compilations of 
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questions asked in the comp . lang . j ava and comp. lang . j ava .programmer news- 
groups to FAQs addressing the topics of JavaBeans and security. 

You can continue your search for answers by joining a Java forum where 
you can post your questions. For example, ITworld.com offers an introduc- 
tory Java Beginner forum (which I formerly moderated). Developers from 
all over the world post questions to this forum, which are subsequently 
answered. However, Java Beginner is only a client-side Java forum — it's not 
designed to answer server-side Java questions (although that might change 
by the time this book goes to print). To visit this forum, enter the following 
address in your Web browser: http: //forums.itworlcl.com/webx?230@l87. 
kLaaaIExaed'0@. ee6b804. 

Finally, in your quest for answers, you might consider searching through 
Java newsgroups. Those groups provide answers to many posted Java 
questions. Groups range from the aforementioned comp . lang . j ava and 
comp. lang . j ava . programmer newsgroups to comp . lang . j ava .gui and comp . 
lang. java. databases. 

TIP 

When visiting a newsgroup, consider printing questions and answers and placing the 
printouts in a binder. In that way, you create a resource that can help you down the road 
with your own questions. 



Magazines, Tuto 
Connection 



Various online and print magazines exist to teach you more about Java. For 
example, visit the Java World magazine Web site (http: / /www. javaworld. 
com) to access a variety of online articles that range from introductory to 
advanced treatments of different Java topics. (I'm currently authoring the 
Java 101 column for JavaWorld. This column presents a client-side Java 
course that attempts to cover all of client-side Java over the next few 
years.) Furthermore, the Java Developers Journal Web site (http: / / 
www.sys-con.com/iava/index2.html) provides information about its print mag- 
azine, which offers many helpful articles. And then there is the Informit 
Web site (http: //www. informit. com), which provides access to articles written 
by various book authors. Each article expands on content presented in an 
author's book. 

Another avenue of exploration in your quest to become a very good Java 
developer is online tutorials. These tutorials range from Sun's Java 
Tutorial Web site (http://iava.sun.com/docs/books/tutorial/), which pro- 
vides a series of trails on various Java topics, to the Swing Connection 
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Web site (http: //java. sun.com/products/jfc/tsc/index. html), which provides 
a series of articles on various Swing topics. 

Finally, you'll want to visit the Java Developer Connection (JDC) Web site 
(http://developer.java.sun.com/developer/). Sun provides this Web site as a 
helpful resource to developers. JDC showcases many articles on different 
aspects of Java and also provides access to Sun's extensive Java Bug 
Database. (If you encounter strange Java behavior while developing a pro- 
gram and think this strange behavior is the result of a Java bug, you can 
check out the Java Bug Database to see whether you are correct.) If you are 
a first-time visitor to the JDC, you will be asked to register. Registration is 
free and takes only a few minutes. However, it is a worthwhile endeavor. 

NOTE 

In addition to visiting the aforementioned Java-based Web sites, you might consider vis- 
iting Sun's Java Web site (http: / /java. sun . com), the Java Applet Rating Service 
(JARS) Web site (http: / /www. jars.com), Gamelan (http: / /www.gamelan . com), and 
Java Lobby (http://www.javalobby.com). Sun's Java Web site has the latest informa- 
tion on Its many Java products. You can also download the latest version of each prod- 
uct from that Web site. The JARs Web site provides access to many useful and 
interesting Java applets and applications and offers a review service that rates those 
applets and applications according to various criteria. Gamelan provides numerous tuto- 
rials on a variety of Java topics. Finally, Java Lobby gives you a chance to find out what 
others think about various Java topics. 
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Glossary 

applet A Java program running in the context of a client computer's Web 
browser program. (A client is something that depends on a service being 
provided by a server. For example, a Web browser program is a client of a 
Web server program, because a Web browser depends on the Web server 
sending it HTML and other files, in response to requests that the Web 
browser makes to the Web server.) 

application A standalone Java program — much like a Windows EXE file. 

argument A value passed to a method by way of a method call. 

array A data structure composed of a fixed number of sequential memory 
locations (known as elements). 

array component variable A single storage location in an array's block 
of memory. (Also known as an element.) 

assertion An assumption about program behavior that is expressed as a 
statement containing a Boolean expression. That expression is believed to 
be true when that statement executes. 

automatic type coercion A C/C++ language feature that automatically 
converts a value from one type to another. 

binary operator An operator that performs an operation on its two 
operands. 

binary search A searching technique that searches for a data item in a 
sorted array by starting at the middle element. If the data item is not 
located in that element, the binary search determines whether the data 
item is less than or greater than the data item in the middle element. If the 
result is less than, the binary search ignores the second half of the array 
and searches the first half. Otherwise, the binary search ignores the first 
half of the array and searches the second half. Regardless of which half is 
searched, the binary search examines the middle element of that half and 
repeats the aforementioned process. The search continues until either the 
data item is found or the binary search reaches a point where it is unable 
to continue dividing the array into two halves. 

bitset A data structure that stores an expandable bit (that is, binary 
digit) sequence. Those bits are interpreted either as I's or O's or as 
true/false values. 
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block Zero or more statements placed between { and } characters. 

bubble sort A sorting technique that makes multiple passes over an 
array of data items. During each pass, either the smallest or largest data 
item "bubbles" (moves) to the top of the array. That "bubbling" occurs as a 
result of comparing adjacent data items and swapping them so that either 
the largest or smallest (depending on whether the sorting operation is 
ascending or descending) data item is placed closer to the top. 

bucket An array element in a hashtable that references the first node in 
a linked list. 

bytecode verifier Part of the JVM that ensures a class file's bytecodes 
are valid and don't violate Java's security restrictions. 

bytecodes Java program instructions that are interpreted by the JVM. 

call-by-value The act of the JVM copying a method's argument values to 
memory locations (known as parameters) on the method call stack prior to 
allowing execution to proceed with that method's bytecode instructions. 

character A mapping of a binary number to a symbol. 

checked exception A program-related exception based on a resource- 
related failure. The compiler checks a method's Throws clause for the class 
names of checked exceptions thrown in that method. 

class A source code blueprint that introduces a type consisting of inte- 
grated state and behavior implementation. (Objects are created from 
classes.) 

class block initializer An initializer that makes complex class initial- 
ization possible. A class block initializer consists of the static keyword, an 
open brace character, initialization code, and a close brace character. 

class field A field that is unique to a class. The class and all objects cre- 
ated from the class share the class field. (Also known as a static field.) 

class field initializer An initializer that makes simple class field initial- 
ization possible. A class field initializer combines an expression with an 
assignment operator, which evaluates the expression and assigns its result 
to a class field after a class loads and before any of its methods execute. 

class file A file that consists of bytecodes, has a name taken from the 
class's name (found in the source code), and has a .class file extension 
attached to its name. 

class library An organized collection of class files. 



class loader Part of the JVM that locates and loads class files. 
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class method A method associated with a class and able to access the 
class's class fields. (Also known as a static method.) 

coercion polymorphism A single operation serving several types 
through implicit type conversion. 

collection An object that stores other objects. The object doing the stor- 
ing is often referred to as a container. 

comment Symbols and textual information that document source code. 
(They are ignored by the compiler.) 

composition The act of designing a class with reference fields that refer 
to other objects. When an object is created from that class and object refer- 
ences are assigned to the object's reference fields, the object is said to be 
composed of the other objects. Aggregation is a synonjon for composition. 

condition A Boolean expression that, when evaluated, determines what 
happens next in either a decision or loop statement. 

constant A read-only variable. Sometimes referred to as a final variable 
(or final, for short). 

constructor A special method used to initialize a newly created object. 
That method has the same name as the class and does not have a return 
type. However, it may have a parameter list. 

CPU starvation A scenario in which a low-priority thread never gets 
access to a processor because higher priority threads are constantly run- 
ning. 

critical section Code that manipulates shared data. 

dangling-else problem Incorrectly assuming that an else matches up 
with a certain if, when that is not the case. The problem arises from 
improperly formatting If-Else statements and forgetting that an else 
matches up with the nearest if. 

data structure An organized grouping of variables. 

deadlock A scenario in which multiple threads cannot proceed because 
each thread holds another thread's lock, and no thread is able to release its 
lock. 

deserialization The act of reconstructing a serialized object so that it 
contains the same state as it had when serialized. 

destructor A C++ language feature used to deconstruct objects during 
their destruction process. 
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dynamic method binding The act of the compiler binding a method call 
to an object. When that method is called, a hidden reference to the current 
object passes to that method and can be accessed (from a source code per- 
spective) by using keyword this. 

element See array component variable. 

encapsulation The integration of fields, which represent state, and 
methods, which represent behaviors, into a single class — a user-defined 



entry-condition loop A loop that evaluates its Boolean expression 
before executing statements. 

enumerated type A reference type with a restricted set of reference val- 
ues. 

enumeration An object created from a class that implements the 
Enumeration interface. Such an object is used to iterate over all objects con- 
tained in a related data structure. 

escape sequence Special syntax that specifies non-printable characters 
and characters that cannot directly appear in character literals or string lit- 



evaluated The execution of bytecode instructions that represent the vari- 
ous parts of an expression to produce the expression's value. 

exception A flow of execution that diverges from its normal flow because 
of failure. Also, an object created from an exception class that is either 
thrown to the JVM or created by the JVM. 

exception chaining Wrapping an exception object inside a new excep- 
tion object and throwing the new exception object. 

exit-condition loop A loop that evaluates its Boolean expression after 
executing statements. 

expression A combination of operators and operands that, when evalu- 
ated, produces a value of a specific type. 

externalization A form of serialization and deserialization where you 
have complete control over those tasks. 

field A variable that holds a state attribute value and is declared inside a 
class but outside the class's methods. 

file A sequence of b3^es on some storage medium. 



type. 



erals. 



finalizer Code placed in an object's finalize ( ) method. 
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function A C/C++ term denoting a named block of executable code that is 
not part of a class. 

garbage collector JVM code that runs (periodically) in the background, 
and is responsible for locating unreachable objects, calling their finalizers, 
checking once again whether those objects are still unreachable and (if so) 
destroying those objects (and reclaiming their memory). 

hashing The technique of applying a mathematical function to a key's 
bits, so that a large number of bits maps to a smaller number of bits. The 
smaller number of bits typically represents an integer index that identifies 
an array component variable. 

hashtable A data structure that stores data items as key/value pairs. 
Keys are mapped from a large domain of values to a narrower range of 
array indexes. 

heap A special JVM memory area where object images are stored. 

helper method A private method that helps a non-private method 
accomplish its task. 

HotJava The first all-Java Web browser, produced by Sun's Green Team 
to run applets and prove that Java has a place on the Internet. 

identifier A sequence of characters that names a variable, class, method, 
interface, package, or label. 

implementation inheritance The capacity for a type implementation 
(that is, a class) to extend one or more type implementations (that is, 
classes). 

inclusion polymorphism A situation in which a type can be another 
type's subtype. Every subtype value can appear in a supertype context, 
where the execution of the supertype's operations (on that value) results in 
the execution of the subtype's equivalent operations. (Also known as sub- 
type polymorphism.) 

index An integer value that identifies an array component variable, 
infinite loop A loop that never ends. 

infix operator An operator whose symbol appears between its operands 
(at the source code level). 

information hiding The act of hiding an internal class's design so that 
code dependent on that class does not break when future changes are made 
to that design. 
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inheritance The capacity for a type (known as a subtype) to extend 
another type (known as a supertype) through the addition of new capabih- 
ties and/or the redefinition of the supertype's existing capabihties. (Classes 
can extend classes, and interfaces can extend interfaces.) 

initializer A language feature that initializes all or part of either a class 
or an object. 

inner class A non-static class, declared inside another class, a block, or a 
class instance creation expression, that has access to the class and instance 
members of all enclosing classes. 

instance block initializer An initializer that makes complex object ini- 
tialization possible. An instance block initializer consists of an open brace 
character, initialization code, and a close brace character. 

instance field A field that is unique to an object. Each object gets its 
own copy of an instance field. (Also known as a non-static field.) 

instance field initializer An initializer that makes simple object field 
initialization possible. An instance field initializer combines an expression 
with an assignment operator, which causes the expression to evaluate and 
its result to assign to an object field during the constructor call portion of 
an object's creation. 

instance method A method associated with an object instance and able 
to access an object's instance fields. (Also known as a non-static method.) 

interface A language feature that introduces (but does not implement) a 
type at the source code level. 

interface inheritance The capacity for a type implementation (that is, a 
class) to implement one or more interfaces. 

interpreter A computer program that reads an instruction, figures out 
what the instruction means, and executes related native microprocessor 
code to carry out the meaning of that instruction. 

interpretation The process of using an interpreter to execute a program. 

iteration One execution of a loop's statement. 

Java A simple, object-oriented, network-sawy, interpreted, robust, 
secure, architecture-neutral, portable, high-performance, multithreaded, 
and dynamic language. 

Java Development Kit Sun's toolkit for executing Java software. That 
toolkit includes tools, documentation, demos, and Sun's class library. 

Java Native Interface A mechanism that connects class files with 
native code libraries. 
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Java Runtime Environment The SDK without development tools and 
examples. 

JavaBeans component A Java program building block that conforms to 
the JavaBeans specification and runs in the context of other programs. 
Those building blocks can be combined to quickly create a program. 

keyword Any Java reserved word apart from true, false, and null. Those 
three reserved words represent literals, not keywords. 

label An identifier, immediately followed by a colon character, that 
identifies the target statement of a loop control statement. 

linear probing The act of hashing a key to an array index and searching 
the linked list, referenced by the element at that index, for a key-value pair. 

linear search A searching technique that searches for a data item in an 
array, by starting at the first element and examining each successive ele- 
ment until either the data item is found or there are no more elements to 
search. Can also be used to search for a data item in a linked list. 

link A self-referential field in a self-referential class. 

linked list A data structure consisting of linked nodes. 

literal A character sequence that denotes a value in source code. 

local variable A variable that exists within the context of a block and 
whose scope is limited to that block and any nested blocks. 

logic error An error (such as division by zero) that arises during execu- 
tion because of poorly written code. 

loop One or more statements that are repeatedly executed. 

magic number A literal value that appears in source code and repre- 
sents something of significance (such as a count or length). 

method A named block of statements that is declared in a class and that 
represents a behavior. 

method call A statement that calls a method and optionally passes 
arguments to that method. 

method call chaining The act of specifjdng several method calls in a 
single statement. In that statement, each method call is separated from the 
previous method call by using a period separator. 

method call stack A data structure, used in conjunction with method 
calls, that keeps track of each method call's return points, local variables, 
and parameters in a nested last-in-first-out fashion. (The most recent 
return point, local variable and parameter combination is located at the top 
of the method call stack.) 
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method overloading The declaration of multiple methods (in the same 
class) that have the same name but different parameter lists. 

multiple implementation inheritance Implementation inheritance 
where a class can extend multiple classes. 

multiple interface inheritance Interface inheritance where a class 
implements multiple interfaces. 

multithreading Multiple threads executing code in the same program. 
Also, the capability to run multiple threads, either at the same time (if each 
thread is given its own processor) or almost at the same time (if all threads 
share a single processor). 

namespace A collection of names. 

node An object created from a self-referential class. 

Oak Java's original name. 

object An instance of a class that represents an entity (such as a bank 
account or a vehicle) in source code. 

octal escape sequence An escape sequence that represents a single 
character by specifying that character's numeric value (from 0 through 255) 
using Octal notation — three digit characters, where the leftmost digit char- 
acter ranges from 0 to 3 and the remaining digit characters each range 
from 0 to 7, that follow a single backslash character. 

operand A value that is transformed into another value by an operator. 

operator A language feature, represented by a token, that transforms 
one or more values (of a certain type) into a new value. 

operator overloading Using the same token to represent multiple oper- 
ators. The appropriate operator is chosen by the types of its operands. 

overloading polymorphism Using a single operator symbol or method 
name for different operations. 

override The act of declaring a method in a subclass that has the same 
name, parameter list, and return type as a method in that class's super- 
class. The subclass method effectively replaces the superclass method and 
is the method called via a reference to the subclass. 

package A library of top-level classes and interfaces. 

parameter A variable declared in a method's parameter list, created 
when the method is called, assigned a copy of an argument value prior to 
the method's block of statements being executed and destroyed when the 
method completes (and before execution returns to the method's caller). 



24 71710_Glossary 11/21/01 3:18 PM Page 807 




Glossary 807 



parametric polymorphism A class declaration that allows the same 
field names and method signatures to associate with a different type in 
each instance of that class. 

parse Breaking a string of characters into meaningful chunks (known as 
tokens). For example, a string containing a telephone number can be bro- 
ken into an area code, a prefix, and the number. 

path The sequence of directories that must be traversed to locate either a 
directory or a data file. 

platform The underlying computer architecture and operating system. 

pointer A variable that contains the address of another variable. 

pointer dereference A C/C++ operator that, when applied to a pointer, 
returns the value of the variable whose address is stored in the pointer 
variable. 

polymorphism The capability of an entity to assume many forms. 
(Water is a good example: It is either a liquid, a solid, or a gas.) From an 
object-oriented perspective, there are four kinds of polymorphism: coercion, 
overloading, parametric, and inclusion (subtype). For example, inclusion 
(subtype) polymorphism makes it possible to invoke a supertype's operation 
and have a subtype's operation execute instead. 

postfix operator An operator whose symbol appears after its operand 
(at the source code level). 

precedence The manner by which certain operators evaluate their 
operands before other operators in an expression. For example, in 4 + 2 * 
3, * evaluates its operands before +. 

prefix operator An operator whose symbol appears before its operand 
(at the source code level). 

preprocessor That part of a C/C++ compiler that processes #includes, 
#def ines, and other commands before compilation starts. 

primitive type A JVM-defined Boolean or numeric type. 

priority The relative importance of a thread. That importance deter- 
mines how often a thread scheduler schedules a thread for execution and is 
commonly expressed as an integer value. 

process A running program. 

property A key-value pair of strings that identifies a configurable item of 
information and is capable of being saved to a file or some other storage 
medium (and retrieved at a later point in time). 
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quantum The amount of time apportioned to each equal priority thread 
by a thread scheduler. An equal priority thread can run for a maximum of a 
quantum. After the quantum expires, another equal priority thread is 
scheduled for execution. 

queue A data structure that stores a sequence of objects and guarantees 
that the first object inserted into the tail of the queue is the first object 
removed from the queue's head. For that reason, a queue is known as a 
first-in/first-out (FIFO) data structure. 

race condition The act of two or more threads attempting to access the 
same data at the same moment. 

ragged array A table that has a different number of columns for each 
row. 

recursion The act of a method either directly or indirectly (by way of 
another method) calling itself. 

reference The address of an object's or array's memory space. Some 
JVMs might implement that address as an actual memory address, 
whereas other JVMs might implement that address as some kind of index 
into a table of values. 



reference type A developer-defined type that is either a class type, an 
interface type, an array type, or null. 

reserved word An identifier that has special meaning to the language. 
Examples include while, int, and null. 

round-robin scheduling A time-sliced scheduling mechanism that 
forces each of several equal-priority threads to run for a specific quantum. 
Without round-robin scheduling, the currently running thread would con- 
tinue to run until either it blocks or a higher-priority thread becomes ready 
to run. 

scope The visibility of an identifier to other parts of a program's source 
code. 

separator One or two tokens that separate some language features from 
other language features. 

serialization The act of saving an object's state so that the object can be 
reconstructed with the same state at a later point in time. 

servlet The server-side equivalent of an applet. A servlet can cooperate 
with applets (and applications) to accomplish significant tasks. 



shadows The act of a local variable declaration preventing access to a 
same-named field by using only the field's name. 
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short circuiting The behavior of the conditional AND and conditional 
OR operators, whereby the right operand is not evaluated whether the left 
operand is false (conditional AND) or true (conditional OR). 

side effect A modification to a variable that results from evaluating an 
expression. 

signature The name of a method along with its return type, optional 
parameter list (between round brackets), and optional modifier and access 
specifier keywords. 

single implementation inheritance Implementation inheritance where 
a class can extend one and only one other class. 

single interface inheritance Interface inheritance where a class 
implements one and only one interface. 

singleton A class from which only a single object can ever be created. 
That class consists of a single private constructor and some kind of 
getlnstanceO method that creates that object the first time it's called. 
Subsequent calls to that method always return the same reference to that 
object. 

special character escape sequence An escape sequence that repre- 
sents either the backslash, double quote, or single quote printable charac- 
ters, or the backspace, form feed, newline, carriage return, or horizontal tab 
characters. 

stack A data structure that stores a sequence of objects and guarantees 
that the last object pushed onto the top of that data structure is the first 
object that will be popped off, upon request. For that reason, a stack is 
known as a last-in/first-out (LIFO) data structure. 

starting class file The first class file to be loaded when a program is 
executing. 

statement A language feature that (typically) evaluates an expression 
and performs a meaningful action based on the value of that expression. 

static method binding The act of the compiler binding a method call to 
a class. When that method is called, NO hidden reference to a current 
object passes to that method. As a result, the static method (or class 
method, if you prefer) cannot access an object's instance fields. 

stream A conduit by which a sequence of bytes flows from a source to 
specific program code or from specific program code to a destination. That 
conduit is represented by an object. 



string A sequence of characters. 
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subclass A class that inherits implementation from another class. Also 
known as a derived or child class — or a subtype. 

subinterface An interface that inherits constants and method signatures 
from another interface. Also known as a subtype. 

superclass A class that contains implementation to be inherited by other 
classes. Also known as a base or parent class — or a supertype. 

superinterface An interface that contains constants and method signa- 
tures to be inherited by other interfaces. Also known as a supertype. 

synchronization The act of serializing thread access to a critical section. 
When one thread is executing within a critical section, no other thread is 
allowed access. 

syntax The arrangement of tokens that specifies one or more language 
features. 

task A unit of work, which can be expressed as a TimerTask object. 

ternary operator An operator that performs an operation on its three 
operands. 

The Sieve of Eratosthenes A mathematical technique developed by the 
ancient Greeks for determining whether a number is prime. 

thread An independent execution path through program code. 

time-slicing The capability of running equal priority threads so that 
each thread executes for the same amount of time. 

token A basic language element (such as a reserved word, an operator 
sjnnbol or symbols, a literal, and so on). Also, any sequence of characters 
that represents a fundamental data item (such as the area code in a 
telephone number). 

twos-complement A format for storing negative integers, whereby the 
magnitude is revealed by flipping bits and adding one to the result. 

type A specification for a set of values and a set of operations that can be 
legally applied to those values to produce new values. 

unary operator An operator that performs an operation on its one 
operand. 

unchecked exception Either a program-related exception based on a 
flaw in a program's logic or a JVM-related exception. The compiler does not 
check a method's Throws clause for the class names of unchecked excep- 
tions thrown in that method. 
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Unicode A universal character set that defines characters used in major 
written languages (such as Japanese, Chinese, French, Arabic, English, and 
so on). 

Unicode escape sequence An ASCII character sequence that repre- 
sents a Unicode number by using \uxxxx, where each x represents a hexa- 
decimal digit. 

value A data item (such as an integer, a floating-point number, a charac- 
ter, a Boolean true or false, and so on). 

variable A named storage location that accommodates values of a specific 
type. 

vector A data structure that stores data items in an expandable internal 
array. Typically, a fixed-size array is used to store those data items. From 
the vector's perspective, the array doesn't expand: When the array fills, the 
vector allocates a larger array, copies all data items from the old array to 
the new array and destroys the old array. 

virtual machine A computer program that mimics a computer. 

wrapper A class whose objects wrap themselves around data items of 
primitive types: Each object wraps itself around a single primitive type 
data item. 
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»> operator, 46 

/* comment delimiter, 56 

// comment delimiter, 56 



abs ( ), 600 

abstract classes, 10, 140-141, 

245, 260-265 

interfaces vs., 263-265 

polymorphism and, 260-265 
abstract interfaces, 228 
abstract keyword, 261 
abstract method, 152-153, 

261-265 
abstract pathname methods 

for files, 614-618 
Abstract Windowing Toolkit 

(AWT), 15 
AbstractSet, 546-548 
access specifiers, 143-144, 149, 

150-152, 158-161 
activeCount ( ) method, 

384-385 
add ( ), 600, 602 
additive operators, 46, 85-86, 

582, 585 
addressing, 11 
aggregation (See also 

composition), 235 
AND operator, 87-92 
anonymous array 

creation, 498 



anonymous classes, 35 
anonymous inner classes, 

324-326 
API, 7, 11, 229 
append ( ), 475-476 
applets, 10, 14, 21-22 

threads and multithreading, 
373, 377 
Application Programming 

Interface (API), 2 
applications, 21-22 
architecture neutral 

concept, 10 
archives and packages, 

445-448 
arguments, 149 

call by value in, 165-166 

command line, 37 
arithmetic operations, 61 
arraycopy ( ), 500-501 
arrays, 9, 37, 64, 78, 100, 210, 

495-512, 538 

access to, 499-500 

anonymous creation of, 498 

arraycopy ( ) and, 500-501 

binary searches, 501, 506-507 

bubble sort, 501-503 

character, strings vs., 463 

cloning, 219-220 

copying, 500-501 

creating, 496^99 

dimensioning of, 507-510 

elements in, 78, 496, 499-500 

equals ( ) for, 511 
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getRuntime ( ), 511-512 

index of, 78 

initializer for, 497-499 

length field vs. length ( ), 511 

length property in, 82 

linear searches, 501, 504—506 

linked lists and, 537 

list implementation and, 
549-550 

memory allocation of, 511-512 

new keyword and, 496 

object status of, 511-512 

one-dimensional, 210, 508 

ragged, 510 

searching, 501-507 

size of, 79 

sorting, 501-507 

two-dimensional, 507-510 

variables, 76-78, 81-83 

vectors and, 529-532 
ASCII, 54-55, 650 
assignment operators, 60, 

86-87 

B 

backslash character for 

escape sequence, 72 
behaviors (See also methods), 

141, 148 
BigDecimal class, 599-603 
Biglnteger class, 599-603 
binary operators, 85 
binary searches, 501, 506-507, 

567-569 
binary to decimal conversion, 

581-582 
binding, method (See method 

binding) 
bits, 54 

bitsets, 512-517 

constructors for, 513 
indexes and, 512-514 



initialization of, 513 
methods for, 513 
Sieve of Eratosthenes and, 514 
bitwise complement operator, 
99 

bitwise operators, 60, 87-90 
blocked state, in threads and 

multithreading, 410 
blocks, block statements, 83, 

110, 128, 149 

class block initializers in, 
287-290 

initializers,296-299 

logic errors and. 111 

Try statement in, 347-348 
boolean, 78 
boolean keyword, 60 
boolean literals, 72 
boolean operators, 87-90, 220 
Boolean type, 46, 60 
boolean values, 285 
bounds checking, 9 
braces, 44, 83, 141 
brackets, 3, 78-79, 84 
Break, 47 

Break statement, 115, 117, 

123-125, 127 
bubble sort, 501-503 
buckets, properties and, 519 
Buffered Stream classes, 

639-642 
buffers 

Buffered Stream classes, 
639-642 

memory mapped, 611 

string (See string buffers) 
byte, 78 
byte type, 60 

bytecode verifier logic, 12 
bytecodes, 9-10, 12 



c 

C#, 7, 38 

C languages, 8, 10-11, 13, 113, 
255, 307 

error handling in, 334-336 

Java vs., 38-47 

thread support in, 372 
call-by-value in, 165-166 
call stack, 167-168 
calling methods, 100, 161-170 
capacity ( ), 476-477 
capacity of vectors, 529 
case conversion, in characters, 

459-461 
case sensitivity of Java, 59 
cast operator, 63-64, 80, 84 
casting, 269 

casting super- and subclasses, 

204-207 
Catch clause, 348-352 

superclasses and, 352 

throwing exceptions from 
352-360 

Try statement and, 364 
catching exceptions, 348-360 
categories of streams, 635 
category, in inheritance, 195 
chained if-else, 114 
chaining method calls, 164-165 
chaining, exception, 356-360 
char, 45-46, 61, 78, 116, 227, 456 
character arrays, strings and, 

463 

Character class, 455 
character literals, 72-74 
character type, 61 
characters, 455-461, 495 

char and, 456 

charValue ( ) method in, 456 
classification of, 456-459 
constructing, 456 
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converting, 459-461 

digit ( ), 459-461 

extracting from strings, 468^69 

forDigit ( ), 459-461 

getType ( ) method, 456^58 

isDigit ( ), 457 

isLetter ( ), 457 

isMirrored ( ) in, 458^59 

"is" methods and, 456-457 

toLowerCase ( ), 459 

toTitleCase ( ), 459 

toUpperCase ( ), 459 

Unicode, 54, 458 

UnicodeBlockof ( ) method in, 
456, 458 
charAt ( ), 479-481 
charValue ( ) method, 456 
checked exceptions, 339-342 
child processes, 657-659 
Circle.java example package, 

441-442 
class block initializers, 

287-290 
class field initializers, 283-287 
class fields, 146 
class files, 11-12, 35 

packages and, 437 
class initializers, 282-290, 303 

instance initializers with, 
299-301 
class keyword, 140, 227 
class libraries, 12, 428-429 
class loader, 11 
class locks, 395-396 
class methods, 154, 163, 249 
Class objects, 208-210 
class suffix, 209-210 
class variables, 76 
classes, 4, 10-11, 35, 44, 57, 64, 

139, 140-142, 193 

casting in, 204-207 



coUections and, 538-570 
constructors and, 173-175 
fully qualified names of, 209 
information about, 208-210 
information hiding and, 170-183 
inheritance and, 196 
interfaces vs., 227 
nested (See nested classes) 
packages and, 427, 428 
root, 207-226 

self-referential classes, 535-538 
streams, 636-649 
Vfrappers, 533 
CLASSPATH environment 
variable, 36 

in packages, 436-437, 439, 444 
client-side applications, 15 
clone ( ) method, 211-220 
Cloneable interface, 210-220, 

229 

cloning objects, 210-220 
close ( ), 230, 635, 638 
coercion polymorphism, 246 
collections and CoUections 

API, 495, 538-570 

binary searches in, 567-569 

classes vs., 538 

Collections API and, 538 

copy ( ), 554-557 

empty, 553-554 

enumeration ( ), 557-558 

fill ( ), 554-557 

hierarchy of interfaces in, 
539-546 

implementations in, 546-553 

indexOfSubList ( ) in, 568-569 

interfaces and, 539-546 

lastlndexOfSubList ( ) in, 
568-569 

List interface in, 543-544 

list(Enumeration) method 
for, 558 



Listlterator interface in, 544 

Map interface in, 544-545, 

551-553 
MapEntry interface in, 545 
max ( ) in, 559-561 
methods for, 540-542 
min ( ) in, 559-561 
nCopies ( ) in, 563 
replaceAll ( ), 556-557 
reverse ( ) in, 561-562 
Set interface and, 542, 546-548 
singleton ( ) and singletonList 

( ), 562-563 
SortedMap interface in, 

545- 546, 551-553 
SortedSet interface in, 542-543, 

546- 548 

sorting and sort ( ), 563-569 
swap ( ) list elements in, 

566-569 
synchronized, 569-570 
unmodifiable, 570 
utilities and, 553-570 
comma, 84 

command line interfaces, 

649-655 
comments, 55-57 
commercial development 

tools, 19-20 
comparator order, 559 
compareTo ( ), 464-466 
compareToIgnoreCase ( ), 

464-466 
compilers and compiling, 

10-12, 33-35 

comments and, 56 

for packages, 438 

for strings, 461-462 
complement operators, 99-100 
composition and inheritance, 

234-236 
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compound assignment 

operators, 60 
concatenation and concat ( ) 

46, 85-86, 466-467 
conditional operators, 60, 

90-92 

conditional statements, 112 
constants, 146-148 

initialization of, 289-290 
constructor variables, 76 
constructors, 156-157, 170-175, 

182, 311 

for bitsets, 513 
for files, 613-614 
initializers and, 303 
instance field initializers and, 

293, 294 
singletons and, 175-176 
superclass, 200-201 
for threads and multithreading, 

379 

throws clauses and, 344—345 

wrappers and, 534 
content operations in, 612 
Continue statement, 47, 59, 

126-127 
conventions used in book, 2--1 
conversion of characters, 

459-461 
conversion of primitive types, 

62-64, 80 
conversion of strings, 467-468 
copy ( ), 554-557 
copyValueOf ( ), 463 
countTokens ( ), 484-486 
CPU starvation, in threads 

and multithreading, 410 
Craps Game sample program, 

22-37 

critical section code, 392-396 
curly brackets as block 
delimiter, 110 



D 

daemon threads, 375, 386 
dangling else problem, 113 
data files, 612 

Data Stream classes, 642-645 
data structures, 495, 496-532 

arrays as, 496-512 

bitsets as, 512-517 

enumerations as, 517-518 

hashtables as, 518-523 

objects as, 496 

properties as, 523-526 

stacks as, 527-528 

vectors as, 529-532 

wrappers as, 533-535 
database management systems 

(DBMS), synchronization in, 

389-391 
databases, flat Hies and flat 

file databases, 625-634 
deadlock, 396-399, 645 
debugging 

dumpStack ( ) method, 385-386 

threads and multithreading, 
385-386 

toString ( ) method and, 
225-226, 385-386 
decimal numbers, 75 
decimal points {See also 

floating point), 74-75 
decision statements, 109-117 
declaring variables, 77-79, 

128-130 
deep cloning, 216-217, 220 
default constructors, 171 
default serialization/ 

deserialization, 660-669 
defragmentation of heap, 307 
delete ( ), 46, 478-479 
deleteChar ( ), 478-479 



deploying and installing Java 
applications, 
InstallAnywhere tool, 20 

deprecated methods, 374 

deserialization, 660 

destructors, 311 

development tools, 14-21 
commercial versions of, 19-20 
downloading SDK 1.4 for, 16-17 
Forte development tool as, 20 
freeware, 20-21 
InstallAnywhere tool, 20 
Integrated Development 

Environment (IDE) for, 19-20 
Java Development Kit (JDK) as, 
14-16 

Java Native Interface (JNI) 
and, 19 

Java Runtime Environment 
(JRE) and, 16, 18 

JBuUder development tool as, 20 

JCreator for, 20-21 

Macintosh Rimtime for Java 
(MRJ) as, 16 

NetBeans for, 20-21 

Software Development Kit 
(SDK) as, 15-21 

Visual Age for Java development 
tool, 20 
digit ( ), 459-461 
dimensions, array, 507-510 
directories, 34 

for packages, 432, 444 
directory files, 612 
divide ( ), 600 
division, 93-94 
do loop, 121-123 
documentation, 33 

comments and, 57 
domain names, in 

packages, 433 
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double, 44-45, 59, 61, 78, 227 
double precision floating 

point type, 61 
doubleValue ( ), 601 
dumpStack ( ) method, 385-386 
dynamic concept of Java, 11 
dynamic method binding, 

249-251, 263 

switch logic vs., 255-260 



E (natural logarithm) 

constant, 589 
EDIT program, 1 
editions of Java, 15 
editors, 11, 33 

element, array, 78, 496, 499-500 
else, 113 

Employee program showing C 

vs. Java, 38-47 
empty collections, 553-554 
empty statement, 128 
encapsulation, 141-142, 193, 

245 

endsWith ( ), 464-466 
ensureCapacity ( ),476-477 
Enterprise Edition Java, 15 
entity, in inheritance, 195 
entry condition loops, 120 
enum, 45 

enumerate ( ) method, 384-385 
enumerated threads, 384-385 
enumerated types, 177-179 
enimieration ( ), 557-558 
Enumeration interface, 

517, 542 
enumerations, 517-518 
environment variables, 36 
equality operators, 60, 92, 

220-223, 585 
equals ( ) method, 221-224, 

464-466, 511 



equalsIgnoreCase ( ), 464-466 
Error class, 338-339 
error and error codes (See 
also exceptions and 
exception handlers), 334-336 
error messages, 36 
error, standard error, 654-655 
escape sequences, 54-55, 72-74 
evaluation operators, 86-87 
evaluation of expressions, 100 
event handling, 14 
exception chaining, 356-360 
Exception class, 337-338 
exceptions and exception 
handlers, 269-312, 333-369 
Catch clause in, 348, 349-352 
catching exceptions in, 348-360 
chaining, 356-360 
checked, 339-342, 
creating an exception class for, 

340-342 
Error class in, 338-339 
error codes to objects and, 

334-336 
Exception class in, 337-338 
Finally clause in, 360-364 
getCause ( ) method in, 357 
inheritance and, 346-347 
initCause ( ) method in, 357 
JVM and, 336 
main ( ) and, 345 
multiple catch clauses in, 

350-352 
redundant code clean up in, 

360-364 
standard error devices and, 337 
standard error in, 654—655 
Throw statement, 342-343 
Throwable class in, 336-339 
throwing exceptions from Catch 
clauses in, 352-360 



throwing, 130, 206, 339, 
342-348 

Throws clause in, 340, 346-347 
and constructors in, 344-345 
and inheritance in, 346-347 

Try statement in, 131, 
347-348, 353 

unchecked, 339-342 

variables, 76 
exec ( ), 655-656 
execution, 35-37 
exit condition loops, 122 
Explorer, 14 
exponents, 600 
expressions, 71, 100-102, 130 
extending interfaces, 233-234 
extends keyword, 45, 197 
extensions, file, 11, 34, 36 
extemalization and 

Extemalizable interface, 

672-677 



false, 59, 220 
fields, 139, 141-148 

access specifiers in, 143-144 
accessing, 158-161 
class, 146 

constants and, 146-148 

constructors and, 172-173 

declaration of, 143 

initialize to default values, 
290-299 

initiahzers of, 283-287, 292-299 

instance, 145-146 

modifiers in, 145 

self-referential classes, 535-538 

shadowing, 160-161 

StreamTokenizer, 678 
file access, 9 
File class, 613 
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file extensions, 11, 34, 36 
file manipulation methods, 

618-622 
filenames, 11, 37 
files, 611, 612-634 
abstract pathname methods for, 

614-618 
constructors for, 613-614 
content operations in, 612 
data files, 612 
directory files, 612 
File class in, 613 
file manipulation methods in, 

618-622 
Finally clause in, 631-632 
flat files and flat file databases 

in, 625-634 
initializing file object in, 

613-614 
listRoots ( ) in, 613 
name and attribute operations 

on, 613-622 
pathnames and, 614-618 
pointers to, 634 

random access data file content 

operations in, 623-634 
random access data files in, 612 
read operations in, 622-634 
separator characters and, 613 
sequential access data file 

content operations in, 622-623 
temporary files and 

createTempFile ( ) in, 613 
write operations in, 622-634 

FileStream class, 636-639 

fill ( ), 554-557 

filter streams, 645 

final constants, 146 

final classes, 140-141 

final fields, 145 

final method, 152-153, 204 

finalization, 223, 281, 311-316 



calling of, specific, order, etc., 
314 

finalize ( ) method and, 312 
resurrection vs., 315-316 
running, 315 

finalize ( ) method, 223, 312 

Finally clause, 360-364 
files and, 631-632 
throwing exceptions fi'om, 
362-364 

fiat files and fiat file 
databases, 625-634 

float, 3, 45, 61, 78 

float point values, 3, 45, 61, 72, 
74-75, 78, 583-589 
internal representation of, 

583-585 
FP strict in, 587-588 
imperfections in, 588-589 

flush ( ), 635 

for loops,117-119, 634 

forDigit ( ), 459-461 

foreign language characters, 
74 

Forte development tool, 20 
forward references, 295 
FP strict, 587-588 
ft"actions, 600 
fragmentation of heap, 307 
freeware development tools, 20 
frozen objects, 611 
ftp, 9 

FTP downloads SDK, 17 
fully qualified names, 209, 434 
functions, 44 

G 

garbage collection, 9, 223, 281, 
305-311 

finalization and, 312 
gc ( ) method and, 311 



phantomly reachable objects in, 
310 

reachable objects in, 308-311 
Reference Objects API n, 

310-311 
resurrection vs., 315-316 
running, 311 

softly reachable objects in, 310 
thrown exceptions and, 312 
unreachable objects in, 308-311 
weakly reachable objects in, 310 

gc ( ) method, 311 

gcd ( ), 602 

get ( ), 522), 523 

getCause ( ) method, 357 

getChars ( ), 479-481 

getPackage ( ) method, 430 

getProperty ( ), 523 

getRuntime ( ), 511-512 

getter methods, 181 

getType ( ) method, 456-458 

Gosling, James, 13 

goto, 47 

graphical user interface (GUI), 

15, 649 
graphics, 10 

greater than operators, 94-96 
Green, 13-14 

H 

hash codes, 223-224, 297 
hashing, 519 
HashMap, 551-553 
HashSet, 546-548 
Hashtable class, 520 
hashtables, 223, 518-523, 538 

buckets and, 519 

get ( ) in, 522 

Hashtable class in, 520 

initial capacity of, 520 

linear probing and, 519 
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load factor of, 520 

methods for, 520-521 

put ( ) in, 522 
hasMoreTokens ( ), 484-486 
header, in interfaces, 228 
heap (See also garbage 

collection; memory 

allocation), 305, 307, 314 
helper methods, 151 
hexadecimal code, 54-55 
hexadecimal numbers, 75 
hierarchy of threads, 416 
high performance of Java 

10-11 

history of Java development, 

13-14 
HotJava, 14 

HTTP downloads of SDK, 17 
Hypertext Markup Language 

(HTML), 57 
Hypertext Transfer protocol 

(HTTP), 9 

I 

I/O, 611 
icons, 2 

identifiers, 57-59, 71, 78 
if else, 112-114 

chained, 114 
dangling else in, 113 
if, 111-112 

implementation inheritance, 

196-207 
implementations. 546-553 

hsts, 549-550 
Map interface in, 551-553 
Set interface in, 546-548 
SortedMap interface in, 551-553 
SortedSet interface in, 546-548 
Import directive, in packages, 
433-437 



inclusion polymorphism, 246, 

247, 254-255-260, 263, 265 
indexes 

array, 78 

bitsets and, 512-514 
indexOf ( ), 471-472 
indexOfSubList ( ) in, 568-569 
infinite loops, 127 
infinity, positive or 

negative, 586 
infix operators, 85 
information hiding, 170-183 
inheritance (Sec also 

polymorphism), 45, 140, 

193-243, 245 

category in, 195 

classes and, 196 

composition vs., 234-236 

entity in, 195 

exceptions and exception 
handlers and, 346-347 

extends keyword in, 197 

final methods and, 204 

implementation type, 196-207 

initializers and, 301-305 

interfaces, 229-230 

multiple, 230, 232-233 

multiple implementation, 200 

nested classes, 323-324 

overriding methods and, 
201-204 

polymorphism and, 206-207 

private access and, 204 

relationships in, 194, 234 

single, 230 

single implementation, 197 
subclass/superclass casting in, 

204-207 
subclasses in, 199 
subtypes in, 196 
superclasses in, 199-201 



supertypes in, 196 

throws clause and, 346—347 

tree hierarchy in, 195 
inheritance chart, 194 
init ( ), 128, 303-304 
initCause ( ) method, 357 
initial capacity, of 

properties, 520 
initial state, in threads and 

multithreading, 410 
initializers, 281, 282-305 

arrays, 497^99 

class, 282-290, 303 

class block, 287-290 

class field, 283-287 

constructors and, 293-294, 303 

forward references with, 295 

inheritance and, 301-305 

init method and, 303-304 

instance block,296-299 

instance field, 292-299 

instance, 290-299 

mixing class and instance, 
299-301 

for subclasses, 303-305 

for superclasses, 303-305 
initializing variables, 79-83 
inner classes, 35, 319-326 
insert ( ), 481-482 
InstallAnywhere tool, 20 
instance variables, 76 
instance block 

initiahzers,296-299 
instance field initializers, 

292-299 
instance fields, 145-146 

initialize to default values, 
290-299 
instance initializers, 290-299 

anonymous inner classes 
and, 325 

class initializers with, 299-301 
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instance inner class, 319-320 
instance methods, 153-154, 163 
instanceof operator, 4, 46, 
95-96 

runtime type information 
(RTTI), 265-273 
int, 45, 46, 62, 78 
integers (See also Biglnteger 

class), 46, 60, 62, 72, 75, 

580-583 

binary to decimal conversion in, 
581-582 

internal representation of, 
580-582 

negative values in, 581 

positive values in, 581 
Integrated Development 

Environment (IDE), 19-20 
interface keyword, 227, 228 
interfaces, 4, 10-11, 57, 64, 193, 

212-213, 226-234, 245 

abstract, 228 

abstract classes vs., 263-265 
classes vs., 227 
collections, 539-546 
declaring, 227-229 
extending, 233-234 
header for, 228 
implementation of, 229-233 
inheritance and, 229-230 
interface keyword in, 227-228 
multiple inheritance in, 230, 

232-233 
multiple, 232-233 
nested, 317, 545 
packages and, 427, 428 
public in, 228 
reference types vs., 227 
references in, 231 
single inheritance in, 230 
sub-, 234 
super-, 234 



tagging, 229 

threads and multithreading, 
376-378 
international characters, 74 
Internet service providers 

(ISP), 17 
interning strings and intern 

( ), 470-471 
interpreted languages, 9 
interpreters, 9, 12 
interrupt ( ) method, in 

threads and multithreading, 

415^18 
interrupted threads, 406-408 
intValue ( ), 601 
is a relationships, 194, 234 
"is" methods, 456-457 
isAlive ( ) method, 381-382 
isDigit ( ), 457 
isLetter ( ), 457 
isMirrored ( ), 458-459 
isProbablePrime ( ), 602 
Iterator interface, 542 

J 

Java Archive (JAR) files, 
445-448 

creation of, 445-446 

extracting from, 446 

metadata and, 446 

packages, 445^48 
java.applet, 428 
java.awt, 428 
java.awt.event, 429 
java.beans, 429 
Java Database Connectivity 

(JDBC), 288-290 
Java Development Kit (JDK), 

14-16 
java.io, 429 



javaJang, 429, 436 

Java Language Specification 

(JLS), 4, 84 
Java Native Interface ( JNI), 19 
java.net, 429 

Java Runtime Environment 

(JRE), 16, 18-19 
java.security, 429 
java.util, 429 
Java. version, 526 
Java Virtual Machine (JVM), 

9-11, 100, 167, 247, 290, 336 
JavaBeans, 21-22 
javac compiler, 11, 34-35 
JBuilder development tool, 20 
JCreator, 20-21 
join ( ) method, 382-384, 409, 

418 

just-in-time (JIT) compilers, 
10, 12 

K 

key-value pairs, in properties, 

523, 526 
keywords, 59, 140 

L 

labels, 57, 125 
lastlndexOf ( ),471^72 
lastlndexOfSubList ( ) in, 

568-569 
launcher tool, 35 
left shift operators, 96-98 
length ( ), 472-473, 477-478 
length field vs. length ( ), in 

arrays, 511 
less than operators, 94-96 
libraries, 9, 11-12, 427 
line.separator, 526 
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linear probing, properties, 519 
linear searches, 501, 504-506 
linked lists, 495, 536-538 

arrays and, 537 
links, self-referential classes, 

535-538 
Linux, 1, 17 
List class, 306 
List interface, 306, 543-544 
list(Enumeration) method, 558 
Listlterator interface, 544 
listRoots ( ), 613 
lists, 495, 536-538 

copy ( ), 554-557 

fill ( ), 554-557 

implementing, 549-550 

nCopies ( ) in, 563 

replaceAll ( ), 556-557 

reverse ( ) in, 561-562 

singleton ( ) and singletonList 
( ), 562-563 

subList ( ), 550 

swap ( ) list elements in, 
566-569 
literals, 71-76 
load factor, properties, 520 
local variables, 76 
local inner classes, 320-324 
local variable declaration, 128 
locks and blocks, 392-396 
logic errors, block statements 

and. 111 
logical complement 

operators, 60 
logical operators, 87-90 
long, 45, 62, 78 
long integer type, 62 
loop control statements, 109, 

110, 117-127 
loops, 4, 46-47, 59, 100, 109-110, 

117-127, 634 

in threads and multithreading, 
375, 408 



M 

Mac, 15, 16 

Macintosh Runtime for Java 

(MRJ), 16 
main ( ), 35, 37, 44, 172, 203 

exceptions and exception 
handlers and, 345 

threads and multithreading and, 
375-376 
mantissa, 584 
Map interface, 544-545, 

551-553 
MapEntry interface, 545 
Math class, 589-592 
mathematics, 579-608 

BigDecimal class in, 599-603 

Biglnteger class in, 599-603 

binary to decimal conversion in, 
581-582 

classes for, 589-592 

E (natural logarithm) constant 
in, 589 

exponents, 600 

float value sets in, 587-588 

floating point issues, 587-589 

floating point types in, 583-586 

FP strict in, 587-588 

fi'actions in, 600 

imperfect floating point types in, 

588-589 
infinity in, positive or 

negative, 586 
integer types in, 580-583, 580 
mantissa and, 584 
Math class in, 589-592 
Math class methods in, 590-591 
negative values in, 581 
normalization in, 584 
operators for, 582-583, 585-586 
overfiow in, 582-583, 585-586 



PI constant in, 589 

positive values in, 581 

pseudorandom numbers in, 
593-599 

random numbers and, 592-599 

rounding mode constants in, 
600-601 

underflow in, 582-583, 585-586 

value sets in, 587-588 
max ( ), 559-561, 600 
memory allocation (See also 

garbage collection; heap), 9, 

78, 305-311 

arrays, 511-512 

garbage collection and, 305-311 
memory leaks, 306-311, 312 
memory mapped buffers, 611 
metadata, in Java Archive 

(JAR) files, 446 
method variables, 76 
method binding, 247-260 

dynamic, 263 

static, 247 
method call {See also calling 

methods), 162 
method call chaining, 164-165 
method call stack, 167-168 
methods, 57, 139, 141, 148-156 

abstract, 261-265 

access specifiers in, 149, 
150-152 

arguments in, 149 

binding {See method binding) 

bitsets, 513 

block statements and, 149 
call-by-value in, 165-166 
call stack in, 167-168 
calling, 161-170 
chaining calls in, 164-165 
class, 154, 163, 249 
collections and, 540-542 
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declaration of, 148-149 
dynamic binding of, 249-251 
final, 204 
helper, 151 

instance, 153-154, 163 
List interface in, 543-544 
Map interface in, 544-545 
MapEntry interface in, 545 
Math class, 590-591 
modifiers in, 149, 152-153 
naming, 149 
Object class, 207-208 
overloading, 155-156 
overriding, 152, 201-204, 213, 

221-223 
parameters in, 149-150 
Process class, 655-656 
properties, 520-521, 524 
Random class, 596 
recursion in, 168-170 
returning values in, 150 
scope of parEimeters in, 150 
signature of, 149, 212, 234 
singletons and, 175-176 
SortedMap interface in, 545-546 
SortedSet, 542-543 
stack, 528 
static, 249 

StreamTokenizers, 678-680 

variables in, 164 

vectors, 529-531 
Micro Edition Java, 15 
Microsoft, 1, 14, 17 
min ( ), 559-561, 600 
mirrored characters, 458-459 
mod ( ), 602 

modifiers, 145, 149, 152-153 
movePointLeft, 601 
MS DOS, 1 

multiline comments, 56 
multiple implementation 



inheritance, 200 
multiple interfaces, 232-233 
multiplicative operators, 

93-94, 582, 585 
multiply ( ), 600 
multithreading (See threads 

and multithreading) 

N 

namespaces, 428 
naming conventions 

abstract pathname methods for 

files, 614-618 
class names, 140 
constants, 147 
field names, 142 
filenames, 11 
methods, 149 
objects, 158 

packages, 430, 432^33 
pathnames and, 614—618 
threads and multithreading, 
378-380 

native method, 152-153 

natural logarithm (E) 
constant, 589 

natural order, 559 

Naughton, Patrick, 13 

nCopies ( ), 563 

negate ( ), 600 

negation operator, 85, 98, 582, 
585 

nested blocks, 110 

nested classes, 281, 317-326 

anonymous inner classes in, 

324-326 
inheritance and, 323-324 
inner classes in, 319-326 
instance inner class in, 319-320 
interfaces and, 317 
local inner classes n, 320-324 



parameters and, 323-324 

scope in, 323-324 

static kejrword and, 318 

top level, 317-319 

variables and, 323-324 
nested interfaces, 545 
NET platform, 7 
NetBeans, 20-21 
Netscape, 14 
networking, 9 
new keyword, 44, 156-157, 

305-306, 496-499 
nextToken ( ), 484-486 
nodes, in self-referential 

classes, 535-538 
nonblocking I/O, 611 
normalization, 584 
notes, tips, cautions, 2-3 
notification and notify ( ) 

method, 224, 399-408 
nuU, 59, 64, 72, 75-76, 223 
nidi literal, 75-76 
numeric type, 60 

0 

Oak, 13 

Object class (See also root 
class), 207-226 

methods of, 207-208 
object locks, 395-396 
object oriented programming, 

8, 139, 193, 245 
object serialization (See 

serialization) 
objects, 100, 139, 156-183, 193 

arrays as, 511-512 

class suffix for, 209-210 

cloning of, 210-220 

comparator order, 559 

constructor for, 156-157, 
170-175 

data structures and, 496 
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equality of, 220-223 
fmalization of, 223, 281, 311-316 
garbage collection and, 223, 
305-311 

information hiding and, 170-183 
initialization of, 303 
max ( ), 559-561 
min ( ), 559-561 
naming, 158 
natural order of, 559 
new keyword for, 156-157 
order of, 559 

reachable and unreachable, 
308-311 

referencing, 221 

singletons and, 175-176 

storage of, 517 
octal escape sequence, 74 
octal numbers, 75 
one-dimensional arrays, 

210, 508 
open ( ) method, 230 
operands, 84 

operators, 3-4, 44, 45-47, 60, 71, 
84-100, 227 

expressions and, 100-102 

mathematical, 582-583, 585-586 

overflow in, 582-583, 585-586 

overloading, 585 

precedence in, 102 

underflow in, 582-583, 585-586 

OR operator, 87-92 

os.name, 526 

output, 44 

overflow, 582-583, 585-586 
overloaded methods, 155-156 
overloaded operators, 46-47, 

87, 585 
overloading and 

polymorphism, 246 
overriding methods, 152, 

201-204, 213, 221-223, 263 



Package directive, 432-433 
Package object, 430-432 
packages, 57, 209, 427-452 

archives and, 445-448 
calling, 428 

Circle.java example of, 441-442 
class files and, 437 
class library, 428-429 
classes and, 428 
CLASSPATH environment 

variable in, 436^37, 439, 444 
compiling, 438 
creating, 437-440 
definition of,428-432 
directories and, 432, 444-445 
domain names and, 433 
examples of, 437^48, 437 
fully qualified names in, 434 
getPackage ( ) method for, 430 
Import directive in, 433-437 
information on, 430-432 
interfaces and, 428 
location of, 439, 444-445 
namespaces and, 428 
naming, 430, 432^33 
Package directive in, 432-433 
Package object in, 430-432 
Rectangle Java example of, 

442-443 
Shape.java example of, 440-4A1 
Square Java example of, 442 
UseGraphicsjava example 
of, 444 

parameters, 149-150 
nested classes and, 323-324 

parametric polymorphism, 
246, 247 

parent processes, 657-659 

parentheses, 3, 83 
in operator precedence, 102 



passing values, 100 
passwords, 10 
PATH, 17, 35 
pathnames and, 614-618 
period, 84 

phantomly reachable 

objects, 310 
PI constant, 589 
Pipe Stream classes, 645-648 
platform independence, 10 
platforms, 9 
Point class, 199 
pointers, 305 
pointers, file, 634 
polymorphism, 206-207, 

245-279 

abstract classes and, 260-265 
coercion, 246 

dynamic method binding and, 
263 

dynamic, 249-251 

inclusion, 246-247, 254-260, 
263, 265 

method binding and, 247-260 

overloading, 246 

parametric, 246-247 

Rectangles and Squares demo of, 
251-255 

subtype, 255-260, 263, 265 

switch logic vs., 255-260 
pop instructions, 285-286, 294, 

527-528 
portability, 10 

postdecrement operator, 99, 

582, 585 
postfix operators, 85 
postincrement operator, 99, 

582, 585 
precedence of operators, 102 
predecrement operator, 98, 

582, 585 
prefix operators, 85 
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preincrement operator, 90, 98, 

582, 585 
preprocessors, 44 
prime numbers, 602 
primitive types, 3, 59, 60-64, 

209, 227, 495, 497 

conversion of, 62-64 

wrappers for, 533-535 
primitive variables, 76 
printing, 44, 115, 653 
priority, in threads and 

multithreading, 410-412 
private, 44, 150-152, 181, 228 

inheritance and, 204 

singletons and, 175-176 
private fields, 143-144 
processes, 655-659 

child, 657-659 

exec ( ) in, 655-656 

methods for, 655-656 

parent, 657-659 

standard error in, 657-659 

standard input/output in, 
657-659 

streams and, 657-659 
program development and 

execution environment, 

11-12 

programming languages, 8 
programs, 21-37 

applets as, 21-22 
application structure in, 37 
applications in, 21-22 
arguments, command line, 37 
class files in, 35 
CLASSPATH and, 36 
compilation of, 33-35 
Craps Game sample program, 

22-37 
directories for, 34 
documentation in, 33 
editors for, 33 



error messages in, 36 

execution of, 35-37 

file extensions for, 34, 36 

JavaBeans in, 21-22 

launcher tool for, 35 

main ( ) in, 35, 37 

PATH in, 35 

pubhc access in, 37 

servlets as, 21-22 

signature in, 37 

source code of, 22-33 
properties, 523-526 

getProperty ( ), 523 

java.version, 526 

key value pairs in, 523, 526 

line.separator, 526 

methods for, 524 

os.name, 526 

Properties class in, 523 

setProperty ( ), 523 

store ( ), 524 

System class in, 526 

system, 526 
Properties class, 523 
protected access, 150-152, 213, 

228 

protected fields, 143-144 
pseudorandom numbers, 

593-599 
public access, 37, 44, 150-152 

interfaces, 228 
public fields, 143-144 
public classes, 140-141 
push instructions, 294, 

285-286, 527-528 
put ( ), 522), 523 

Q 

queue data structures, 537 
quotation marks, 3, 72, 76 



R 

race conditions, 391-396 
ragged arrays, 510 
random access data file 

content operations in, 

623-634 
random access data files 

in, 612 

random numbers, 592-599 
reachable objects, garbage 

collection, 308-311 
read ( ), 622-636, 638, 650 
readExtemal ( ), 672-677 
readObject ( ), 660-661, 669 
Rectangle.java package 

example, 442-443 
Rectangles and Squares 

method binding demo, 

251-255 
recursive methods, 168-170 
redirection of I/O, 652 
redundant code clean up, 

360-364 
Reference Objects API, 

310-311 
reference types, 64, 227, 

269, 497 

enumerated types as, 177-179 
reference variables, 76 
references, 4, 221 

interfaces, 231 

self-referential classes, 535-538 
Reflection API, 208 
regionMatches ( ), 464-466 
register, 46 

relational operators, 94-96 
relationships and inheritance, 

194, 234 
replace ( ), 467-468, 482-483 
repIaceAll ( ), 556-557 
reserved words, 44, 45-46, 59 
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resource leaks, 312 
resource management, 

flnalization and, 311-316 
resurrection vs., 315-316 
return, 44 

Return statement, 130, 150 
reverse ( ), 483, 561-562 
right shift operators, 96-98 
Ritchie, Dennis, 38 
robust languages, 9 
root class {See also Object 

class), 207-226 
round robin scheduling, in 

threads and multithreading, 

414 

rounding mode constants, 

600-601 
run ( ), in threads and 

multithreading, 375, 378, 381, 

384, 410 
Runnable interface, 376-378 
runnable state, threads and 

multithreading, 410 
runtime type information 

(RTTI), 245, 265-273 

s 

scheduling thread execution, 

371, 409-414 
scope, 150 

nested classes, 323-324 
searching arrays, 501-507 
searching strings, 471-472 
security, 9-12 

pointers and, 305 

system properties and, 526 
self-referential classes, 495, 

535-538 
semicolon, 84 
separator characters, 613 
separators, 71, 83-84 



sequential access data file 
content operations in, 
622-623 

Serializable interface, 229 

serialization, 611, 659-677 
custom, 669-672 
default, 660-669 
deserialization and, 660 
externalization and, 672-677 
readObject ( ) in, 660-661, 669 
transient kejrword in, 664-669 
writeObject ( ) in, 660-661, 669 

server-side applications, 15 

servers, 21 

servlets, 21-22 

Set interface, 542, 546-548 

setCharAt ( ), 482-483 

setLength ( ), 477-478 

setProperty ( ), 523 

setScale ( ), 600-601 

shadowing, 160-161 

shallow cloning, 214-216, 220 

Shape.java example package, 
440-441 

shared data, in multithreading 
and synchronization, 389 

Sheridan, Mike, 13 

shift operator, 96-98, 582, 585 

shiftLeft ( ), 602 

short, 45, 62, 78 

short circuiting, in operators, 
91 

short integer, 46, 62, 78, 582, 
585 

side effect, in operators, 90-91 
Sieve of Eratosthenes, 

The, 514 
signature, 37, 44, 149, 212, 234 
signum ( ), 601 
simple variables, 76, 77 
single implementation, 

inheritance, 197 



single line comments, 56 
singleton ( )and singletonList 

( ), 562-563 
singletons, 175-176 
size ( ), 529 
sleep ( ) method, 409 
sleeping threads and 

multithreading, 380-381, 392 
softly reachable objects, 310 
Software Development Kit 

(SDK), 1, 15-21, 57 

downloading, 16-17 

Java Native Interface (JNI) 
and, 19 

Java Runtime Environment 
(JRE) and, 16, 18-19 

Windows version of, 18-19 
Solaris, 1, 14-15, 17 
SortedMap interface, 545-546, 

551-553 
SortedSet interface, 542-543, 

546-548 
sorting arrays, 501-507 
sorting and sort ( ), 563-569 
source code, 11 

for book, 4 

Craps Game sample program, 
22-33 

special character escape 

sequences, 73-74 
specifiers, 143-144 
sqrt ( ), 515 

square brackets (See brackets) 
Square.java package 

example, 442 
stack and stack operations, 

285-286, 294, 527-528, 538 

method call to, 167-178 
Standard Edition Java, 15 
standard error devices, 337 
standard error in, 654-655, 

657-659 
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standard I/O, 649-655 

ASCII and, 650 

command line interfaces for, 
649-655 

graphical user interfaces (GUIs) 
for, 649 

origination of, specifying, 
652-653 

printing and, 653 

processes and, 657-659 

read ( ) in, 650 

redirection in, 652 

standard error in, 654—655 

standard output in, 653 
start ( ) method, 375-376, 381 
starting class file, 11 
startsWith ( ), 464-466 
state, 141 

statements, 3, 44-45, 47, 
109-137 

expressions as, 130 
states, in threads and 

multithreading, 410-412 
static 

constants, 146 
fields, 145 

method binding, 247 

method, 152-153, 249 

nested classes and, 318 
storage, files as, 612 
store ( ), 524 
stream tokenizers, 611, 

677-682 

fields for, 678 

methods for, 678-680 
streams, 611, 634-659 

Buffered Stream classes in, 
639-642 

byte oriented categories for, 635 

character oriented categories 
for, 635 

classes for, 636-649 



close ( ) in, 635, 638 

Data Stream classes in, 642-645 

deadlock, 645 

destinations for, 634-635 

FileStream class for, 636-639 

filter streams in, 645 

flush ( ) in, 635 

input and output categories in, 
635 

Pipe Stream classes in, 645-648 
processes and, 657-659 
read ( ) in, 635-636, 638 
sources of, 634—635 
tokenizers for, 677-682 
Unicode Text Format (UTF) and, 

644-645 
write ( ), 638 

Zip Stream classes in, 648-649 
strictfp, 45, 228 
string, 37, 64, 76, 78, 80 
string buffers, 455, 473-483 

appending characters to, 
475^76 

capacity of, 476^77 

charAt ( ), 479-481 

constructing, 474-475 

deleting characters from, 
478-479 

extracting characters from, 
479^81 

getChars ( ), 479-481 

inserting characters in, 481-482 

length of, 477-478 

replacing cheiracters in, 482— i83 

reversing characters in, 483 

substring ( ), 480^81 
String class, 455, 462 
StringBuffer class, 455, 462 
strings, 37, 64, 72, 76, 78, 80, 

115, 224-226, 455, 461-473, 495 

appending characters and 
append ( ), 475^76 



buffers for (See also string 

buffers), 473^83 
character arrays and, 463 
compareTo ( ), 464-466 
compareToIgnoreCase ( ), 

464-466 
comparing, 464-466 
concatenating and concat ( ) 

466^67 
constructing, 461-462 
converting, 467^68 
copyValueOf ( ), 463 
countTokens ( ), 484-486 
deleting characters fi"om, 

478^79 
endsWith ( ), 464-466 
equals ( ), 464-466 
equalsIgnoreCase ( ), 464^66 
extracting characters from, 

468^69, 479-481 
hasMoreTokens ( ), 484-486 
indexOf ( ), 471-472 
inserting characters in, 481^82 
interning and intern ( ), 470^71 
lastlndexOf ( ),471^72 
length of, length ( ) for, 472^73 
nextToken ( ), 484-486 
regionMatches ( ), 464-466 
replace ( ), 467^68 
replacing characters in, 482^83 
reversing characters in, 483 
searching, 471^72 
StartsWith ( ), 464^66 
String class in, 462 
StringBuffer in, 462 
substring ( ) in, 468-469 
toCharArray ( ), 463 
tokenizer acquisition for, 

484-486 
tokenizer creation for, 483^84 
tokenizers for, 483^86 
toLowerCase ( ), 467-468 
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toUpperCase ( ), 467-468 

trim ( ), 467^68 

values passed to, valueOf ( ) 
and, 473 
StringTokenizer class, 455 
subclasses, 140, 199, 265 

casting in, 204-207 

hash code and, 224 

initializers, 303, 304-305 
subinterface, 234 
subList ( ), 550 

substring ( ), 468-469, 480-481 
subtract ( ), 600 
subtype, 196, 269 
subtype polymorphism, 

255-260, 263, 265 
suffix, on type, 74-75 
Sun, 13, 14 

super keyword, 200-201 
superclasses, 199, 200-201, 
207, 294 

casting in, 204-207 

Catch clauses and, 352 

initiahzers, 303-305 
superinterface, 234 
supertypes, 196, 269 
swap ( ) list elements, 566-569 
Swing, 15 

switch logic, dynamic method 

binding vs., 255-260 
switch statement, 114-117 
synchronization (See also 
threads and multithreading), 
11, 371, 389-409 
class locks and, 395-396 
collections, 569-570 
critical section code in, 392-396 
database management system 

(DBMS) example for, 389-391 
deadlock in, 396-399 
interrupted threads and, 
406-408 



locks and blocks in, 392-396 
notification and notify ( ) method 

in, 399-408 
object locks and, 395-396 
race conditions vs., 391-392, 

393-396 
shared data in, 389 
synchronized kejrword for, 393 
volatile kejrword and volatility 

in, 408^09 
waiting and wait ( ) method in, 

399^08 

synchronized keyword, 45, 393 

synchronized method, 152-153 

Synchronized statement, 131 

syntax, 3, 72 

System class, 526 

system properties, 287, 526 

T 

tagging interfaces, 229 
tasks, 386 
TCP/IP, 9 

temporary files and 
createTempFile ( ), 613 

terminating state, in threads 
and multithreading, 410 

ternary operators, 85 

text, 455 

this keyword, 161, 175, 

200-201, 252 
Thread API, 378 
Thread class, 373-376 
threads and multithreading 

(See also synchronization), 

11, 145, 371-425 

activeCount ( ) method in, 
384-385 

alive status of, 381-382, 384 

applets and, 373, 377 

benefits of, 372 



blocked state of, 410 
class locks and, 395-396 
constructors and, 379 
CPU starvation and, 410 
critical section code in, 392-396 
daemon, 375, 386 
deadlock in, 396-399 
debugging, 385-386 
deprecated methods in, 374 
dumpStack ( ) method, 385-386 
enumerate ( ) method in, 

384-385 
enumeration of, 384—385 
equal priority scheduHng in, 

412^14 
garbage collection and, 311 
groups of 415^18 
hierarchy of, 416 
initial state of, 410 
interrupt ( ) method in, 415^18 
interruption of, 40(5-^08 
isAlive ( ) method in, 381-382 
join ( ) method in, 409, 418 
joining in, 382-384 
locks and blocks in, 392-396 
loops and, 375, 408 
main ( ) and, 375-376 
naming of, 378-380 
notification and notify ( ) method 

in, 224, 399-408 
object locks and, 395-396 
priority of, 410^12 
race conditions in, 391-392, 

393-396 
round robin scheduling in, 414 
run ( ) method in, 375, 378, 381, 

384, 410 
Runnable interface for,376-378 
runnable state of, 410 
scheduling execution in, 371, 

409^14 
shared data in, 389 
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sleep ( ) method in, 409 

sleeping, 380-381, 392 

start ( ) method in, 375-376, 381 

states of, 410^12 

support for, internal vs. 

external, 372 
synchronization in {See also), 

371, 389^09 
Synchronized statement, 131 
tasks in, 386 
terminating state of, 410 
Thread API and, 378 
Thread class in, 371, 373-376 
time sliced vs. non-time sliced 

schedulers for, 413-414 
timers for, 386-388 
toString ( ) method, 385-386 
user, 386 

volatile keyword and volatility 

in, 371, 408^09 
waiting and wait ( ) method in, 

224, 399^09 
yield ( ) method in, 414 
Threads class, 371 
Throw statement, 130, 342-343 
Throwable class, 336-339 
throwing exceptions, 130, 206, 

339, 342-348 

from Catch clause, 352-360 
from Finally clause, 362-364 
Throws clause, 219-220, 312, 

340, 346-347 
constructors and, 344-345 
inheritance and, 346-347 

time sliced vs. non-time sliced 

schedulers, 413-414 
Timer class, 386-388 
timers, 386-388 
TimerTask class, 386-388 
timezone property, 287 
toCharArray ( ), 463 



tokenizers, stream (See stream 

tokenizers) 
tokenizers, string, 483-486 
tokens, 455 
tokens, operator, 84 
toLowerCase ( ), 459, 467-468 
top level classes (See also 

nested classes), 317 
toString ( ) method, 225-226, 

385-386 
toTitleCase ( ), 459 
toUpperCase ( ), 459, 467-468 
transient fields, 145 
transient keyword, 45, 664-669 
tree hierarchy of inheritance, 

195 

TreeMap, 551-553 

TreeSet, 546-548 

trim ( ), 467-468 

true, 59, 220, 285 

Try statement, 131, 347-348 
Catch clause and, 349-353, 364 
Finally clause in, 360-362 

two-dimensional arrays, 
507-510 

twos complement, 60 

type errors, 246 

typedef, 45 

types, 3, 9, 44-46, 53, 59-64, 
71, 497 

coercion polymorphism in, 246 
primitive type conversion in, 
62-64 

runtime type information 

(RTTI), 265-273 
self-referential classes, 535-538 

u 

unary operators, 80, 85, 

98-100, 582, 585 
unchecked exceptions, 339-342 



underflow, 582-583, 585-586 
Unicode, 53-55, 61, 71, 73-74, 

116, 458, 644-645 
Unicode Text Format (UTF), 

644-645 
UnicodeBlockof ( ) method, 

456, 458 
UNIX, 13 

unmodifiable collections, 570 
unreachable objects, in 

garbage collection, 308-311 
UseGraphics.java package 

example, 444 
USENIX Conference, 336 
user threads, 386 
utilities, 553-570 

V 

value sets, 587-588 
valueOf ( ), 473 
variables, 57, 59, 76-83, 
100, 164 

array, 76-78, 81-83 
class, 76 

class block initializers and, 288 
constants vs., 146-148 
constructor, 76 

declaration of, 77-79, 128-130 
exception handler, 76 
fields as, 142-148 
initiEilization of, 79—83 
instance, 76 

instance block initializers 

and, 297 
local, 76, 128-130 
method, 76 

nested classes and, 323-324 
parameters as, 149-150 
primitive, 76 
reference, 76 
simple, 76-77,79-81 
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vectors, 529-532, 538 

arrays and, 529-532 

capacity of, 529 

methods, 529-531 

size of, size ( ), 529 
verification, 12 
virtual machine (Sec Java 
A^rtual Machine) 
viruses, 9 

Msual Age for Java 
development tool, 20 

void keyword, 44, 100 

volatile fields, 145 

volatile keyword and 
volatility, 145, 371, 408-409 



xor ( ), 602 



yield ( ) method, in threads 
and multithreading, 414 



zip files, 648-649 

Zip Stream classes in, 648-649 

ZIP tools, 445 



w 

waiting and wait ( ) method, 

224, 399-409 
WeakHashMap, 551-553 
weakly reachable objects, 310 
Web appUcations, 14, 21-22 
Web browsers, 14, 21 
While loop, 4, 46, 59, 110-111, 

119-121 
Windows, 1, 15, 17 

SDK version for, 18-19 
World Wide Web, 14 
wrappers, 495, 532-535 

classes for, 533 

constructors and, 534 

data structures and, 533-535 

for primitive types, 533-535 
write operations, 622-634 
write ( ), 638 

writeExtemal ( ), 672-677 
writeObject ( ), 660, 661, 669 
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